@opengamehq/cli 0.9.8 → 0.9.9
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/AGENTS.md +37 -17
- package/CHANGELOG.md +11 -0
- package/README.md +7 -6
- package/dist/cli.mjs +135 -135
- package/dist/opengame-global.js +3 -3
- package/dist/preflight-worker.mjs +10 -10
- package/dist/runtime-builder.mjs +1 -1
- package/dist/skills/manifest.json +1406 -142
- package/dist/skills/opengame-accessibility/SKILL.md +48 -32
- 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/SKILL.md +32 -6
- package/dist/skills/opengame-assets/SKILL.md +79 -31
- package/dist/skills/opengame-assets/references/pipeline.md +67 -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/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/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/SKILL.md +4 -4
- package/dist/skills/opengame-deploy/SKILL.md +35 -15
- package/dist/skills/opengame-deploy/references/json-events.md +6 -5
- package/dist/skills/opengame-deploy/references/packaging.md +28 -26
- package/dist/skills/opengame-depth/SKILL.md +61 -33
- 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/SKILL.md +85 -39
- package/dist/skills/opengame-front-end/references/menus.md +42 -8
- 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/SKILL.md +42 -27
- package/dist/skills/opengame-lighting/SKILL.md +85 -34
- 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/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/SKILL.md +78 -0
- package/dist/skills/opengame-maps/references/map-spec.md +77 -0
- package/dist/skills/opengame-mobile/SKILL.md +18 -18
- 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/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/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/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/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/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/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/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/SKILL.md +10 -2
- 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/SKILL.md +26 -9
- package/dist/skills/opengame-sdk/references/engines.md +2 -2
- package/dist/skills/opengame-sdk/references/identity.md +10 -11
- package/dist/skills/opengame-stability/SKILL.md +59 -27
- 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/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/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/SKILL.md +113 -48
- 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/SKILL.md +55 -24
- package/dist/skills/opengame-world-physics/references/measured-failures.md +28 -1
- package/package.json +1 -1
|
@@ -0,0 +1,108 @@
|
|
|
1
|
+
# Pacing, attacks and bots
|
|
2
|
+
|
|
3
|
+
Reference configurations for "Pace in enemies met per minute", "Each enemy attacks on its
|
|
4
|
+
own clock" and "Bots read as players" in `SKILL.md`. LC is a wave-survival body-camera
|
|
5
|
+
shooter against the dead; OS a snipers-only free-for-all where every rival is a bot
|
|
6
|
+
presented as a person. Use the numbers as a start for a game of the same kind, then tune
|
|
7
|
+
on real runs.
|
|
8
|
+
|
|
9
|
+
## LC's tide
|
|
10
|
+
|
|
11
|
+
The director that decides who comes, when and from where.
|
|
12
|
+
|
|
13
|
+
- A level every 100 s. The live cap is 9 at the start, plus 0.6 a level, up to 32.
|
|
14
|
+
- Health 80 at level 1 and 100 at level 2, then +25 a level, then x1.06 a level. A head
|
|
15
|
+
round from the starting pistol does 132, so early heads die to one shot.
|
|
16
|
+
- The first figure stands up at 2.5 s and then one every 4 s; first contact in 10 to
|
|
17
|
+
15 s, in front of the player and out of the torch's light.
|
|
18
|
+
- No surge for the first 75 to 90 s, or until the first generator; a surge spreads over
|
|
19
|
+
9 s; the ebb after it runs at two thirds of the rate.
|
|
20
|
+
- Runners from minute 2, a third of arrivals by 3:00, half by 5:00; a first sprinter
|
|
21
|
+
alone at 3:30.
|
|
22
|
+
- Arrivals 16 to 36 m away by walking distance, out of sight, flanks and ahead weighted
|
|
23
|
+
3:1 over behind, the empty side weighted 4x. At level 1 nobody strikes unseen from
|
|
24
|
+
behind.
|
|
25
|
+
- Lull floor: nobody within 25 m for 8 s brings two up 12 to 34 m off.
|
|
26
|
+
- Stragglers: a figure 45 m behind for 4 s, or stuck for 3 s, is replaced and stops
|
|
27
|
+
counting toward the cap.
|
|
28
|
+
- A hemmed-in ceiling: at most 3 attackers within 10 m.
|
|
29
|
+
- Spawn coverage: from every standpoint, spawns on at least three sides at a useful range
|
|
30
|
+
in every door state (short of three sides: 9.7% of standpoints to 0.8%).
|
|
31
|
+
|
|
32
|
+
Targets measured on real runs: at least 8 met in minute one, 14 more in minute two, 20
|
|
33
|
+
more in minute three, no gap over 8 s. "Met" means first within 25 m and in view.
|
|
34
|
+
|
|
35
|
+
### Fear before speed
|
|
36
|
+
|
|
37
|
+
"Fear comes from the dark, the numbers closing and the cost of a mistake, not from being
|
|
38
|
+
struck all the time." LC's six seeded scares, none of which the player can bait:
|
|
39
|
+
|
|
40
|
+
1. A hush of 8 to 12 s, then six runners from two sides.
|
|
41
|
+
2. A surge on an empty reload.
|
|
42
|
+
3. The first sprinter, alone.
|
|
43
|
+
4. A dive out of the dark.
|
|
44
|
+
5. Lightning showing the tree line full.
|
|
45
|
+
6. A silent one behind the player while both hands are busy on a machine.
|
|
46
|
+
|
|
47
|
+
## LC's attacks
|
|
48
|
+
|
|
49
|
+
- Each figure in reach swings on its own clock: a 0.42 s wind-up, hit or miss decided by
|
|
50
|
+
distance at the end of it, a 0.55 s recovery, about 1.1 s between one figure's swings.
|
|
51
|
+
No shared gap, no turn-taking. A figure held back by the crowd within 1.75 m strikes
|
|
52
|
+
from where it stands.
|
|
53
|
+
- 34 damage of 100 a blow, so three blows down (five with the armour perk); a dive does
|
|
54
|
+
45. Health regenerates after 4 s unhurt and is whole in 1.2 s.
|
|
55
|
+
- The leap: a 0.62 s gather from 2.5 to 4.4 m away, a 0.44 to 0.75 s flight that tracks
|
|
56
|
+
the first 34% toward where the player will be, never before 1:35 or within 38 s of the
|
|
57
|
+
last, never two in the air. A landing radius of 0.9 m, smaller than a sidestep's travel
|
|
58
|
+
in the flight time. A miss lands face down and is helpless for 1.5 s.
|
|
59
|
+
- The player's sprint (6.3 m/s) beats the fastest zombie (capped at 4.8) by a clear
|
|
60
|
+
margin; a walk outruns only shamblers.
|
|
61
|
+
|
|
62
|
+
## Calibrate the test player first
|
|
63
|
+
|
|
64
|
+
LC's scripted players backed away at 2.3 m/s where a person aiming backs off at 1.33,
|
|
65
|
+
killed 25 to 30 a minute against a person's 13, and spaced blows 2.2 s against 2.62.
|
|
66
|
+
Numbers tuned on them made the game harmless for a person. Before tuning difficulty on
|
|
67
|
+
bots, replay a real run headless on its seed and require the bench to land within a
|
|
68
|
+
fifth of it, and test a player who just stands (`opengame-depth`).
|
|
69
|
+
|
|
70
|
+
## OS's bot motor model
|
|
71
|
+
|
|
72
|
+
What made rivals read as people in killcams and in the open.
|
|
73
|
+
|
|
74
|
+
- Reaction time from an ex-Gaussian distribution with a floor of 150 ms.
|
|
75
|
+
- Flicks that follow a minimum-jerk path timed by Fitts' law, undershoot, then correct.
|
|
76
|
+
- Aim error that drifts smoothly instead of being resampled each frame.
|
|
77
|
+
- Scoped shots 0.22 to 0.28 s after full zoom, with settle error after a fast scope-in
|
|
78
|
+
(without it, rival quickscopes caused 26 of 37 of the owner's deaths). Modelled on the
|
|
79
|
+
owner's own play: 41% of those shots came within 0.25 s of scoping; a hip flick, a
|
|
80
|
+
0.42 s pause, then a 1 degree correction.
|
|
81
|
+
- Strafe only under 28 m, in committed legs; reload and work the bolt in cover; ignore
|
|
82
|
+
distant shots briefly after a look (head whips 51 to 18); hunt high campers.
|
|
83
|
+
- Drawn facing trails the aim through a critically damped spring of 0.06 s, capped at
|
|
84
|
+
0.6 rad; hits stay on the simulation.
|
|
85
|
+
- Scope choice by distance band: quickscope near, drag-scope middle, hardscope far.
|
|
86
|
+
- No one-frame head lock: in a killcam it "tells the player it was a bot".
|
|
87
|
+
|
|
88
|
+
### The behaviour count
|
|
89
|
+
|
|
90
|
+
Log per match, per bot slot: share of time creeping, one-frame yaw snaps, peeks, seconds
|
|
91
|
+
standing in the open during a fight, seconds to engage a camper, stuck and pacing spells.
|
|
92
|
+
Fix the worst three, and judge every change with a same-frame A/B split by slot in one
|
|
93
|
+
build: alternating 40 s windows on a loaded machine read -13% CPU where the truth was
|
|
94
|
+
+46% and 4.5x the stuck bots, against a noise floor of 20%.
|
|
95
|
+
|
|
96
|
+
### A lobby that feels online (OS)
|
|
97
|
+
|
|
98
|
+
Bots presented as people need a lobby that behaves like one.
|
|
99
|
+
|
|
100
|
+
- Arrivals on a lognormal spread; a lobby fills to exactly its cap only 70% of the time
|
|
101
|
+
("always exactly 32 looks scripted").
|
|
102
|
+
- 5 to 20% of bots leave during a match, with killfeed lines; about 80% stay for the next.
|
|
103
|
+
- Names from a generator in the style of real console handles, mostly lowercase, with
|
|
104
|
+
digits or underscores in 10 to 15% of them, as the owner asked.
|
|
105
|
+
- An empty mic slot rather than fake talking.
|
|
106
|
+
- The match keeps running under the pause menu; a paused player can be killed.
|
|
107
|
+
- Bot powers rate-capped, for example a counter-radar at most once every 5 minutes for
|
|
108
|
+
at most 30 s.
|
|
@@ -124,6 +124,65 @@ const { upToDate } = tileCache.update(navMesh)
|
|
|
124
124
|
a capture, draw links as arcs (`Line2`) coloured by area id, so a missing link on a
|
|
125
125
|
player build is visible.
|
|
126
126
|
|
|
127
|
+
## A gait inside its rate band
|
|
128
|
+
|
|
129
|
+
Pick the clip whose stride fits the ground actually covered, and refuse to stretch it.
|
|
130
|
+
LC's band was 0.9 to 1.15x the capture rate; below a shamble's band the figure stands.
|
|
131
|
+
|
|
132
|
+
```js
|
|
133
|
+
// gaits: [{ action, stride, captureSpeed }] sorted slow to fast; dt > 0
|
|
134
|
+
const speed = groundCovered / dt // after collision, not the requested speed
|
|
135
|
+
const held = smoothSpeed(speed, dt) // hold a change about a third of a second
|
|
136
|
+
let pick = null
|
|
137
|
+
for (const g of gaits) {
|
|
138
|
+
const rate = held / g.captureSpeed
|
|
139
|
+
if (rate >= 0.9 && rate <= 1.15) { pick = g; break }
|
|
140
|
+
}
|
|
141
|
+
if (!pick && held < gaits[0].captureSpeed * 0.67) standAndReach() // too slow for any gait
|
|
142
|
+
else {
|
|
143
|
+
pick ??= nearestGait(held) // between bands: the nearest, clamped
|
|
144
|
+
setGait(pick, Math.min(1.15, Math.max(0.9, held / pick.captureSpeed))) // fade in a quarter second
|
|
145
|
+
}
|
|
146
|
+
```
|
|
147
|
+
|
|
148
|
+
Log figure-seconds whose rate would have left the band; a wall-treading fix that let
|
|
149
|
+
clips slow to 0.1x produced "slow mo" runners.
|
|
150
|
+
|
|
151
|
+
## Pose sentinels in the build
|
|
152
|
+
|
|
153
|
+
Console errors in the shipped build catch the broken poses the owner otherwise finds.
|
|
154
|
+
LC fires on a figure in its rest pose, on both arms held level at the sides for 0.2 s,
|
|
155
|
+
and on a killed figure that has not started to fall within 0.25 s.
|
|
156
|
+
|
|
157
|
+
```js
|
|
158
|
+
function checkPose(fig, now) {
|
|
159
|
+
if (fig.isRestPose()) console.error('rest pose', fig.id, fig.clipName)
|
|
160
|
+
const armsOut = Math.abs(fig.armElevation('left')) < 0.15 && Math.abs(fig.armElevation('right')) < 0.15
|
|
161
|
+
fig.armsOutSince = armsOut ? (fig.armsOutSince ?? now) : null
|
|
162
|
+
if (fig.armsOutSince !== null && now - fig.armsOutSince > 0.2) console.error('arms out', fig.id)
|
|
163
|
+
if (fig.diedAt && now - fig.diedAt > 0.25 && fig.hipDrop() < 0.05) console.error('no fall', fig.id)
|
|
164
|
+
}
|
|
165
|
+
```
|
|
166
|
+
|
|
167
|
+
`armElevation` and `hipDrop` are the game's own measures from the rig (radians from
|
|
168
|
+
horizontal, metres below the standing hip); fill them in for your skeleton.
|
|
169
|
+
|
|
170
|
+
## Crowds without a SkinnedMesh per figure
|
|
171
|
+
|
|
172
|
+
LC drew 32 zombies in 0.50 ms with 162 draws and 1.43 M triangles (9 standing: 0.21 ms):
|
|
173
|
+
|
|
174
|
+
- one float texture of every slot's bone matrices (46 KB for 22 bones a figure), uploaded
|
|
175
|
+
only when it changes, read in the vertex shader;
|
|
176
|
+
- one instanced draw per kind per detail level, at most 27 draws for the horde;
|
|
177
|
+
- full meshes only for the nearest 5 within 8 m; the far field one figure per family,
|
|
178
|
+
with no shadow;
|
|
179
|
+
- figures more than 78 degrees off the view culled (186 draws to 111 to 129);
|
|
180
|
+
- one node material per family, with per-figure values read through
|
|
181
|
+
`reference('material.userData.x')` rather than a material each.
|
|
182
|
+
|
|
183
|
+
Pose every near figure every frame: skipping poses for detail levels had left 144 to 297
|
|
184
|
+
of 720 frames unposed, which the owner saw as walking "very jaggedly".
|
|
185
|
+
|
|
127
186
|
## Other engines
|
|
128
187
|
|
|
129
188
|
- Godot: `NavigationRegion3D`, `NavigationAgent3D` and `NavigationLink3D` for jumps;
|
|
@@ -1,63 +1,101 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: opengame-front-end
|
|
3
|
-
description: Build a browser game's title, menus, first run, loading, settings, results and HUD. Covers menus
|
|
3
|
+
description: Build a browser game's title, menus, first run, loading, settings, results and HUD. Covers menus on the game's world that never cost a frame, menu effects that never move the interface, console-grade pad and keyboard input, interface time on the wall clock, the press that starts play, settings from one schema, an honest loading bar, text that never clips and a HUD from one unit. Use when the menu looks cheap or lags, clicks do nothing, settings reset, or for a title, menu, HUD or share image.
|
|
4
4
|
metadata:
|
|
5
|
-
version: "1.0
|
|
5
|
+
version: "1.1.0"
|
|
6
6
|
---
|
|
7
7
|
|
|
8
8
|
# The front end and the HUD
|
|
9
9
|
|
|
10
10
|
The first thing a stranger sees is the title and the menu, and a button on black
|
|
11
11
|
answers them before the game can. The front end is part of the game, in the same world,
|
|
12
|
-
type and light, and it must never be the thing that hangs
|
|
12
|
+
type and light, and it must never be the thing that hangs, lags or moves under the
|
|
13
|
+
pointer.
|
|
13
14
|
|
|
14
15
|
Rules carry five tags; `opengame-quality-bar` explains them and the game codes. OC's
|
|
15
16
|
owner asked for a console-grade menu 4 or more times and for an honest loading bar 3
|
|
16
|
-
times
|
|
17
|
+
times, LC's owner raised the menu effects 7 times, and OS's owner asked about 9 times for
|
|
18
|
+
screens with no overlap and 6 times for a match that never stops for the menu. Those
|
|
19
|
+
rules come first.
|
|
17
20
|
|
|
18
21
|
## Rules
|
|
19
22
|
|
|
20
|
-
### Every menu
|
|
21
|
-
- **Invariant:** Every menu and the loading screen show the game's world
|
|
22
|
-
- **Technique:** A looping
|
|
23
|
-
- **Reference configuration:** OC's owner: "It should not look like a browser menu screen ... background cinematics, the sound of the cinematics in the background, hover effects". OC's menu film is 5 shots on a 36 s loop (zombies climbing, the squad on patrol, lightning on the beat).
|
|
23
|
+
### Every menu shows the world, with its own sound, and costs no frames
|
|
24
|
+
- **Invariant:** Every menu and the loading screen show the game's world with that scene's sound under it, answer focus with sound, never look like a web page or show a pixelated first frame, and hold the frame-rate floor of play: the world behind the menu is a sharp still, a film proven smooth on this device, or a live scene measured at the play floor.
|
|
25
|
+
- **Technique:** A looping film per screen or a rendered clip of real play, or a full-resolution still of the place in a page layer under a transparent canvas, with the engine drawing only the interface. Draw a live 3D scene behind a menu only once its frame time at native pixel ratio meets the play floor (see `opengame-performance`). Never fake motion by panning or zooming a still. Route the scene's ambience through the menu mix; hover, focus and click sounds come from one kit. Screens change by cut, push or mask instead of opacity crossfades. Hold the still until the first frame is at full resolution.
|
|
26
|
+
- **Reference configuration:** OC's owner: "It should not look like a browser menu screen ... background cinematics, the sound of the cinematics in the background, hover effects". OC's menu film is 5 shots on a 36 s loop (zombies climbing, the squad on patrol, lightning on the beat). OS's owner first asked for motion ("nothing shoudl just be fucking raw static images"), called a faked pan worse ("the still images were actually better here than this shit"), and then: "so many of the pre gameplay screens are SOOO laggy... if we cant show videos in background or anywhere thats fine just show high quality images of each map ... we cannot have anything be laggy or cause freezes etc." OS's live title world cost 174-283 ms of CPU a frame; it now stands on a 4K still with the world off ("A moving clip in the wrong weather is worse than a still in the right one"), and its bar for every menu is 60 fps with no frame over 50 ms. LC's title is a live place (a breathing camera and slow sway) under a 26 KB still that covers it until the live scene's mean level matches, and LC's menus held 60 fps. This rule replaces "every menu is a live scene": OS showed that a still beats a live world that costs frames. Motion durations 120, 160, 220 and 280 ms.
|
|
24
27
|
- **Applies when:** Every game with menus.
|
|
25
|
-
- **Verify:** Load cold in a real browser at native resolution: the first frame is sharp, the film
|
|
28
|
+
- **Verify:** Load cold in a real browser at native resolution: the first frame is sharp, the background moves only if it is a film or a measured live scene, its sound plays after the first press, and every focus change makes a sound. Record each menu's frame times at native pixel ratio: it holds the play floor. Capture the page layer and the canvas apart: with a still background, the canvas alone shows no world.
|
|
29
|
+
|
|
30
|
+
### Menu effects texture a still picture and never move the interface
|
|
31
|
+
- **Invariant:** A tape, CRT, grain or scanline effect on a non-play screen is a texture over a still picture: text and buttons never shake, jitter, lean, roll, tear or warp in a way the eye or the pointer notices, every element is hit where it is drawn, the effect never shows in play, and when the owner names a real object as the target (a VHS tape, a CRT television) the build reproduces that object's measured cues before anything is made stronger.
|
|
32
|
+
- **Technique:** Open the named reference, write its numbers per layer into the design doc and film it beside the build at real speed. Read an adjective ("a bit trippy") as a description of the reference, never as a control to turn up; a stronger version needs the owner's word after they have seen the matched one. After one literal reading is rejected, list the real object's cues (curved glass, bezel, scanlines, a still interface) and show stills beside a reference before making it the default. Use compositor-only layers (opacity and transform). Draw static glass once, in a worker canvas, and bend each small element with CSS transforms recomputed only on open, focus, scroll or resize, so hit areas follow what is drawn. Keep SVG filters, `backdrop-filter` and `clip-path` off layers over a WebGPU canvas, skip a GPU effect pass rather than run it at zero, and let reduced motion remove moving layers rather than freeze them.
|
|
33
|
+
- **Reference configuration:** LC's owner asked for a tape look that was "a bit trppy and distorted"; the lead agent read that as a call for more three times and shipped a second band, hum bars, a sine lean and roll-outs that passed the team's own 10 checks. The owner: "dont shake/jitter the screen... this is way too aggressive we nee da subtle vhs effect". Matched to the reference, LC's tape is grain 0.05 stepping 4 times per 0.5 s, scan lines 1 px in 3 at alpha 0.035, a hum rising 0 to 0.05 then 0.03 over 9 s, one 14vh band with a 0.14 core drifting up over 11 s, and corner falloff 0.26 from 88%, with a pause frame diff of 0.01/255, and drew no later complaint, which is weak evidence of acceptance. LC's CRT took four builds in about 30 h ("the buttons shouldnt literlaly be moving"; "the whol menu anda ll screens should read and look like a retro crt tv... thats the bar") and held as a still curved television: curve 0.028 by 0.036, scanlines on a 3 px period at 0.34 darkness, under 1 px of element error, at most 12 recomputes a second. Measured costs over the canvas: an SVG displacement filter 1.2-2.4 fps, `backdrop-filter` 16-29 fps against 60, `clip-path` 36 fps. LC's menus held 60 fps with under 0.1 ms of interface script a frame.
|
|
34
|
+
- **Applies when:** Title, pause, settings, loading and results screens with a stylised effect, and any effect the owner names by a real object.
|
|
35
|
+
- **Verify:** Sample every element's rectangle 10 times a second for 6 s: none moves. A frame-pair diff of the text layer with the effect on and off is 0. A 5-point hit test on every row lands on that row. A table of values for each layer matches the reference's.
|
|
36
|
+
|
|
37
|
+
### Poster first, and a film only once it plays smoothly
|
|
38
|
+
- **Invariant:** The menu is usable the moment it appears, a background film appears only once it is proven to play smoothly on this device, a film never blocks a control, and motion respects the player's preference.
|
|
39
|
+
- **Technique:** Show the still at once. Once the menu is up, fetch each clip whole into `MediaSource` before playing it, so a slow network cannot stall it mid-loop; never fetch one large clip as a blob at boot, where a failed fetch can break the boot. Pick the clip's tier with `navigator.mediaCapabilities.decodingInfo`, playing only a tier reported smooth and power-efficient, and fade it in only after `requestVideoFrameCallback` shows its first second playing without dropped frames. Start it muted so autoplay is allowed, unmute through the menu mix after a real gesture, crossfade its loop, pause it when the tab is hidden or the menu closes, and keep one shared background element across menus. Reduced motion shows the still with no autoplay; a failed or slow film stays on the still. On phones the still replaces the loading film. Test the codec in a real browser, because automated browsers often cannot decode it.
|
|
40
|
+
- **Reference configuration:** AW gates its menu films on reduced motion and plays their sound at 0.07. ST starts menu audio at a 30% menu mix and never above it. Our originals cap menu film audio at 30% of media gain. OC's loading film was 22.6 s of 1080p30 H.264 at 10.2 MB, later 19 s at 8.7 MB, muted with a poster and skipped on phones; Playwright's Chromium could not decode H.264, so the film never played in OC's own captures. OS's software AV1 decode dropped 257 of 459 frames, and a 46.6 MB clip fetched at boot aborted and failed the release tour; after the fix the tour had 0 failed of 2,968 requests.
|
|
41
|
+
- **Applies when:** Games with a menu film or animated background.
|
|
42
|
+
- **Verify:** Load with reduced motion on: no video plays. Block the video file, or make `decodingInfo` report it as not smooth: the menu works on the still. Hide the tab: the film pauses. Count dropped frames in the first second after the fade: none.
|
|
26
43
|
|
|
27
44
|
### The title is a scene
|
|
28
45
|
- **Invariant:** The title screen shows the game's world, with the game's name as crisp live text and a clear way in.
|
|
29
46
|
- **Technique:** Key art or a looping clip of the world under live DOM type, a scrim only where text needs it, and a semantic Play control focused on load. Keep the promotional wordmark separate from the accessible title. Never bake controls or labels into footage.
|
|
30
|
-
- **Reference configuration:** AW fades its key art in over 620 ms with an 8 s scale from 1.045 to 1. Our originals' rule: no system display face (source a face that matches the world, or draw the title from the game's own bitmap font), no eyebrow above a heading, no gradient text, no emoji as icons.
|
|
47
|
+
- **Reference configuration:** AW fades its key art in over 620 ms with an 8 s scale from 1.045 to 1. Our originals' rule: no system display face (source a face that matches the world, or draw the title from the game's own bitmap font), no eyebrow above a heading, no gradient text, no emoji as icons. LC self-hosts its open-licence faces with `font-display: block` and inlines the font so the first paint needs no fetch.
|
|
31
48
|
- **Applies when:** Every game.
|
|
32
49
|
- **Verify:** Capture the title cold at laptop and 1080p sizes; inspect the computed font family; Tab reaches Play first and Enter starts the game.
|
|
33
50
|
|
|
34
|
-
###
|
|
35
|
-
- **Invariant:**
|
|
36
|
-
- **Technique:**
|
|
37
|
-
- **Reference configuration:**
|
|
38
|
-
- **Applies when:**
|
|
39
|
-
- **Verify:**
|
|
51
|
+
### Console-grade input: one press, taught keys, the right pad, one focused row
|
|
52
|
+
- **Invariant:** An interaction fires on one press (a timed action starts on the press and shows its progress), a moved or new binding is taught until the player uses it, prompts show the buttons of the device in hand, every menu step has exactly one focused row, and a player on a laptop with no mouse can play.
|
|
53
|
+
- **Technique:** One action map for keyboard and mouse, pad and touch, switching prompts the frame another device is used, and deciding the device by recent motion past the dead zone, so a resting stick never takes over from the mouse. Identify a pad by vendor and product id before its name (test the specific maker before a generic "Wireless Controller"), and take every button word from one name table. Keep exactly one enabled row focused; wrap; when a row greys out, move focus to the nearest enabled row; remember focus per screen and tab; let hover move focus without scrolling the list. Make destructive actions holds, or a click that arms and a second click that confirms. A press still held from the action that opened a screen does nothing there until it is released; a fresh press acts. Unplugging a pad pauses with one line of text. Offer a keyboard-only layout for laptops (arrows to look, a key to aim, a key to use). Never move a default binding without the owner's decision, a changelog line and a save migration. Remapping, sensitivity and dead zones are in `opengame-accessibility`.
|
|
54
|
+
- **Reference configuration:** LC's owner: "f should be interactions not e" and "e should also be how u ads (for people without a mosue on laptop btw)"; LC's arrow look reaches 140°/s in 0.22 s. Both owners wanted interactions that answer a press: LC's "interactions should not be holding f to buy a gun it should just be pressing f or holding f but just say press f on the ui", and OS's pickup should "just be pressing f not holding", after 7 asks. LC guards a new screen against a carried-over press for 0.15 s, teaches a moved key every run until it is used, and gives the device to a mouse that moved in the last 3 s, after a resting stick had flipped the device every frame and slowed the mouse through aim help. LC walked 196 scripted menu steps under DualSense and Xbox ids after a regex had named an Xbox pad a PlayStation one; no real pad was ever held, which is the gap. OS's owner: "it says x to pick up but im using a ps5 controller". An OS agent moved E to zoom cycling while serving another ask: "also remember u need ot be able to eds with E as well! why did we remove that?"
|
|
55
|
+
- **Applies when:** Every desktop game with menus, and every game that claims controller support.
|
|
56
|
+
- **Verify:** Walk every screen by keys, by pad under each maker's ids and by mouse, at three aspect ratios, with rows found by name: each step shows exactly one focused row and no keyboard glyph while a pad is in use. Play the first objective on the laptop layout with no mouse. Hold a real pad of each maker before claiming parity.
|
|
57
|
+
|
|
58
|
+
### Interface time is wall time, and the first press on a visible screen acts
|
|
59
|
+
- **Invariant:** Menu animations, input gates, video clocks, countdowns, bars, heartbeats and logged durations run on real elapsed time while the simulation keeps its clamped step; a press on any visible screen acts at once, even during an entrance or a load; a press made just before a screen appears is kept, neither lost nor taken blind; and no prompt offers an action that cannot act yet.
|
|
60
|
+
- **Technique:** Read the wall clock, with a capped step, for curtains, wipes, pointer arming, video, countdowns, heartbeats and every logged duration, and keep the clamped delta for the simulation. Latch input from the first frame, and never gate it on a backdrop or an entrance animation. Release held input on blur and time out wait-for-release latches. Keep a press made in the moments before a menu shows, light its row, and act on it shortly after on a timer that reads the real clock; carry held movement keys across a screen change and drop one-off presses until they are released. Hide a Skip or Continue prompt until its action can act. Game timers that should slow with the game are in `opengame-game-feel`.
|
|
61
|
+
- **Reference configuration:** Six OS bugs came from a 50 ms delta clamp: a 180 ms wipe took about 2 s, clicks stayed unarmed for 1.7 s at 3 fps, the title ignored presses for about 7 s, a countdown on clamped time ran about twice as long on slow machines, and a heartbeat summing clamped deltas reloaded a live game at about 3 fps. A press at about 5 s waited until 10.3 s; fixed, the menu opened 0.6 s after the press. OS's boot bar held 13% for 27.4 s; fixed, its longest hold was 0.88 s. The owner: "i hit d one and i start to hear footsteps but it doesnt do anything and im stuck on this gunsmith screen?... wtf?". LC keeps a press from the 5 s before the menu shows and acts on it about a third of a second after lighting the row: 10 of 10 kept, where 2 of 2 had been dropped. LC's owner: "whyd eos this say skip if its loading".
|
|
62
|
+
- **Applies when:** Every game with a capped simulation step, a loading phase or animated screens.
|
|
63
|
+
- **Verify:** Under a 4x CPU throttle, wipes, countdowns and logged durations match a stopwatch. A press 100 ms after the title draws acts. Press Enter in the moment between ready and the menu appearing: the press is kept and acted on.
|
|
64
|
+
|
|
65
|
+
### The press that starts play starts it, and the match never waits for a menu
|
|
66
|
+
- **Invariant:** The press that starts a run hides the menu in its own frame, starts play with no second wait or "click to take control", and takes mouse look in the same press; in a game presented as online, opening the menu, changing settings, idling or switching tabs never stops the match, and world audio carries on under the menu, ducked.
|
|
67
|
+
- **Technique:** Request pointer lock inside the handler of the press that starts play (with `unadjustedMovement` where the browser supports it), and outside OpenGame request fullscreen only after `pointerlockchange`, because fullscreen spends the user activation; inside OpenGame's frame the page owns fullscreen, so call `og.fullscreen.request()` from a click and never `requestFullscreen` (`opengame-sdk`). Give one owner the lock state and have it confirm a held lock rather than request it again; browsers refuse a lock requested from an Escape keydown. In an online-styled game the simulation clock never reads interface state and the menu only captures input; a solo game pauses as [references/menus.md](references/menus.md) describes. Scripted calls into the page are granted user activation, so test the lock and its refusal with a real click.
|
|
68
|
+
- **Reference configuration:** LC's owner: "we jshould just have the lading screen before the main menu... and then main menua nd hitting new run automatically starts game.. no more loading". LC's New run reaches the first frame of play in 12-23 ms and holds the lock 6-12 ms after the press, where it had taken 280-324 ms and flashed a prompt. OS's owner asked six times, for example "everyone needs to keep playing -> pause is just u opening menu not pausing the game!" and "u should hear the gameplay in background (muted a bit) but not just the voices", and: "and again i said get rid of this weird spawn in shit wher eu dont spawn in and it says click to take control!". In OS, fullscreen spent the activation, so runs fell to the click prompt ("lock+fullscreen both hold in that order, every other order loses the lock"), and a second lock request dropped the lock in 1 of 7 tours.
|
|
69
|
+
- **Applies when:** Every game that takes the pointer; keeping the match running applies to bot-filled and online-styled games.
|
|
70
|
+
- **Verify:** A real-pointer tour logs `document.pointerLockElement` at drop-in, at respawn and after alt-tab. Time the press to the first frame of play. In an online-styled game, film 10 s with the menu open mid-fight: bots move, timers run, and ambience is heard.
|
|
40
71
|
|
|
41
72
|
### A short first run from the title to play
|
|
42
73
|
- **Invariant:** A first-time player reaches play through a short fixed flow with one obvious way forward on each screen, is never stopped by a form, and cannot lose progress by accident.
|
|
43
74
|
- **Technique:** A few fixed screens from the title to play, each with one prominent forward button. Selecting an item previews it and only the button advances; Enter acts on release, so one press never skips a screen. A default name instead of a name prompt: on OpenGame, the signed-in player's handle, filled as `opengame-sdk` shows, and the game's own default name otherwise. Quit, Restart and Reset ask for a second press. A first-spawn hint with the goal and the controls for the device in use, shown once per profile and closing itself. Labels a player understands.
|
|
44
|
-
- **Reference configuration:** OC's flow is title, character, loadout and deploy. Its default name is "Player"; the first-spawn hint closes after 12 s, with keyboard and touch variants; "Early Access", not "Early build 0.1". The owner: "I'm trying to hit Enter to apply and it keeps moving stuff forward"; the character to loadout flow was fixed at R86.
|
|
75
|
+
- **Reference configuration:** OC's flow is title, character, loadout and deploy. Its default name is "Player"; the first-spawn hint closes after 12 s, with keyboard and touch variants; "Early Access", not "Early build 0.1". The owner: "I'm trying to hit Enter to apply and it keeps moving stuff forward"; the character to loadout flow was fixed at R86. OS's loadout took 8 or more asks (Enter confirms, Confirm at bottom right) and passed only under a real interaction test.
|
|
45
76
|
- **Applies when:** Every game with menus before play.
|
|
46
77
|
- **Verify:** In a fresh profile, a stranger reaches play with one Enter or one click per screen. Press Quit once and see a confirm. Die and restart: the hint does not show again.
|
|
47
78
|
|
|
48
79
|
### Saves survive a reload, and the player is told when they cannot
|
|
49
80
|
- **Invariant:** Every setting and profile value the player changes survives a reload, an explicit choice is never changed without telling the player, and the player is told when the browser blocks storage.
|
|
50
|
-
- **Technique:** One settings store written on every change, zero and false included, and read once at boot. A version field with a migration when a default changes, treating old saves as explicit choices. Test storage at boot and show a notice when it throws or is missing. An automatic
|
|
51
|
-
- **Reference configuration:** OC saved only 3 of 21 settings until R104-R107, and profile persistence failed at r79 and r83 before passing at r84. OC's quality rule: one step from Ultra to High after 8 s at a GPU median over 17.5 ms, with a banner, never below High and never in menus. The owner: "Let's make Ultra the base... fall back to High, but not below."
|
|
81
|
+
- **Technique:** One settings store written on every change, zero and false included, and read once at boot. A version field with a migration when a default changes, treating old saves as explicit choices. Test storage at boot and show a notice when it throws or is missing. An automatic change to the tier the player chose steps at most once, never in menus, never below the floor the owner set, and says so on screen; a resolution scaler inside a tier is in `opengame-performance`.
|
|
82
|
+
- **Reference configuration:** OC saved only 3 of 21 settings until R104-R107, and profile persistence failed at r79 and r83 before passing at r84. OC's quality rule: one step from Ultra to High after 8 s at a GPU median over 17.5 ms, with a banner, never below High and never in menus. The owner: "Let's make Ultra the base... fall back to High, but not below." OH renamed its game twice and kept the old save-key prefix so nobody lost their bests.
|
|
52
83
|
- **Applies when:** Every game with settings or a profile.
|
|
53
84
|
- **Verify:** Set every option to a non-default value, including off and zero, reload, and compare. Block site storage in the browser and load: the notice shows.
|
|
54
85
|
|
|
86
|
+
### Settings come from one schema, and rebinding swaps
|
|
87
|
+
- **Invariant:** One typed schema defines every setting, and the settings screen, the store, the defaults, the migration and any import all read it, so a saved or pasted value can only be an allowed value and no two actions ever share a key.
|
|
88
|
+
- **Technique:** Typed fields with ranges, read through a sanitiser on every load and import. Build the settings screen from the schema rather than by hand. Offer copy and paste of settings as text, through the same sanitiser. Put whole looks or presets first, and let the player try one on live after a short pause on it. When a player binds a key another action holds, give that action the old key (a swap), never two actions on one key or one action on none. A reset asks twice.
|
|
89
|
+
- **Reference configuration:** OH keeps 128 settings in one schema with a sanitiser, six whole looks tried on live after 260 ms, settings copied and pasted as text, and resets asked twice; launch QA had found two lanes sharing one key. LC stores its four pad layouts as bindings in the same table. OC's store had saved only 3 of 21 settings (see the rule above).
|
|
90
|
+
- **Applies when:** Every game with more than a handful of settings, deep customisation or remapping.
|
|
91
|
+
- **Verify:** Paste junk settings text: every field lands on an allowed value. Rebind one action to another's key and play both actions. Diff the settings screen's fields against the schema: nothing missing, nothing extra.
|
|
92
|
+
|
|
55
93
|
### The loading bar is honest and always moving
|
|
56
|
-
- **Invariant:** The loading bar follows real work, rises in small steps, never goes backwards, never holds still long enough to look frozen, and reads full only when the next screen responds.
|
|
57
|
-
- **Technique:** Weight progress by bytes, not file counts. Give each blocking stage (shader and pipeline compiles, environment maps, decoding) its own weight, and split it into pieces that each report. Show the bar only after a short delay, so a fast load shows none. The displayed value steps toward the real value one step at a time.
|
|
58
|
-
- **Reference configuration:** OC's bar went to 60%, froze, then jumped to 100% ("can we have it be progressive by 1%"); later it stuck at 97% for 20 s and reloaded (R93), and real iPhones stalled at 97% for 1-3 min until R185. The fix climbs 1% at a time, never holds a number for more than about 0.75 s (0.68-0.73 s measured), has no stall over 300 ms in the timing strip, and appears only after 0.6 s
|
|
94
|
+
- **Invariant:** The loading bar follows real work to the moment play can start, rises in small steps, never goes backwards, keeps moving while shaders compile, never holds still long enough to look frozen, and reads full only when the next screen responds.
|
|
95
|
+
- **Technique:** Weight progress by bytes, not file counts. Give each blocking stage (shader and pipeline compiles, environment maps, decoding) its own weight, and split it into pieces that each report. Show the bar only after a short delay, so a fast load shows none. The displayed value steps toward the real value one step at a time. Draw the count with compositor-only CSS transforms (a strip of digits, a scaled bar), so it keeps stepping while compiles block the page. Show a time-left estimate only if it held close through a whole boot. Test on a throttled connection; a fast local boot hides every stall. What the count weighs, and what "playable" means, is in `opengame-loading`.
|
|
96
|
+
- **Reference configuration:** OC's bar went to 60%, froze, then jumped to 100% ("can we have it be progressive by 1%"); later it stuck at 97% for 20 s and reloaded (R93), and real iPhones stalled at 97% for 1-3 min until R185. The fix climbs 1% at a time, never holds a number for more than about 0.75 s (0.68-0.73 s measured), has no stall over 300 ms in the timing strip, and appears only after 0.6 s; a shader warm-up curtain had added 2.5 s of blank screen. LC's first count read 91% at 0.8 s with play 17-21 s away; fixed, it reached 100% at 22.1 s with play ready at 21.8 s, rising at most 30 points a second and holding an eighth of a second after 100. LC's time-left estimate was 2.8-10.3 s off and was hidden. OS hung at 22% on a hard-coded 0.22, first "fixed" with a fake moving band; the owner: "it should just be loading and 0->100% and then the 5->1 countdown and not hanging".
|
|
59
97
|
- **Applies when:** Every game with a loading screen.
|
|
60
|
-
- **Verify:**
|
|
98
|
+
- **Verify:** Film the bar on a throttled connection and read each shown value from the pixels with its time: no backward step, no hold past the limit, and play responds when the bar reads full.
|
|
61
99
|
|
|
62
100
|
### A boot veil with a deadline
|
|
63
101
|
- **Invariant:** The loading cover lifts when the game is ready, and lifts anyway at a deadline with the reason recorded, so it can never hang.
|
|
@@ -69,17 +107,24 @@ times; those rules come first.
|
|
|
69
107
|
### Loading that cannot hang, failures you can act on
|
|
70
108
|
- **Invariant:** Every wait has a deadline and a fallback, and a failure says what happened and offers a way forward.
|
|
71
109
|
- **Technique:** Every fetch, decode and scene preparation has a timeout. Fence stale async loads so a rapid menu change cannot land an old scene. Play starts when the scene and controls are ready, not when a decorative clip ends.
|
|
72
|
-
- **Reference configuration:** ST's rule: loading is complete only when the next advertised action responds.
|
|
110
|
+
- **Reference configuration:** ST's rule: loading is complete only when the next advertised action responds. LC opens a pressed menu page's frame at once, reading "OPENING" in 26 ms, while its late script arrives.
|
|
73
111
|
- **Applies when:** Every game.
|
|
74
112
|
- **Verify:** Kill the network mid-load and press every button on the screen that appears.
|
|
75
113
|
|
|
76
114
|
### Every click lands, wherever the button is released
|
|
77
115
|
- **Invariant:** Every press and release reaches the game, whether the pointer is released over the canvas, over a page overlay or outside the window, so no button stays held and no menu click is lost.
|
|
78
116
|
- **Technique:** Listen for release on the window, not the canvas, or capture the pointer on press with `setPointerCapture`. Clear held buttons on `pointercancel`, `touchcancel`, blur and visibility change, and set `touch-action: none` on the game surface. Prove it with clicks the running game receives, not with a stand-in page.
|
|
79
|
-
- **Reference configuration:** OC's owner: "sometimes on the menu screens / pause I can hover over buttons but clicking them does nothing, randomly". The web runtime heard mouseup only on the canvas, so a press released over a page overlay left the button held, and the menu's wait-for-release guard then ignored every later click: 60 of 60 clicks after an overlay release were missed. Forwarding the release took 12 lines and brought it to 0 of 60 (R167). That proof came from a stand-in test page with no in-game clicks, which is the gap to close.
|
|
117
|
+
- **Reference configuration:** OC's owner: "sometimes on the menu screens / pause I can hover over buttons but clicking them does nothing, randomly". The web runtime heard mouseup only on the canvas, so a press released over a page overlay left the button held, and the menu's wait-for-release guard then ignored every later click: 60 of 60 clicks after an overlay release were missed. Forwarding the release took 12 lines and brought it to 0 of 60 (R167). That proof came from a stand-in test page with no in-game clicks, which is the gap to close. OS's careless-player fuzzer found Enter ignored after a key was held over a tab switch.
|
|
80
118
|
- **Applies when:** Every browser game with DOM over the canvas or menus drawn in the canvas.
|
|
81
119
|
- **Verify:** In the running game, press on the canvas, drag onto an overlay or out of the window, release, then click a menu button. It responds on 20 of 20 tries.
|
|
82
120
|
|
|
121
|
+
### No text is cut, overlapped or off screen at any size
|
|
122
|
+
- **Invariant:** On every screen and in every state, no text is cut, ellipsised, off screen, overlapping another element or below a readable size, at any window size the game supports, and a rule that shortens text to fit drops decoration before meaning.
|
|
123
|
+
- **Technique:** Have the game report its own layout: dump every box and text extent from the DOM (or every draw command of a canvas-drawn interface) for each screen and state, at many window sizes and at the HUD-scale and safe-area settings, set through the real settings screen. Intersect each text range with its clipping ancestors, scope each check under its screen, crop each finding, and exit non-zero on any finding outside an allowlist whose entries carry a reason. Reserve whole rectangles for slots whose content changes, not one item's width. Keep characters inside the frame, fading before any image edge. Run it after every interface pass and in every release.
|
|
124
|
+
- **Reference configuration:** OH audits every screen at eight sizes from 1100x900 to 2560x1440 with a root size of `clamp(10px, 0.78vw + 0.55vh, 24px)`, three type sizes a screen and nothing under 13 px; its rule for shortening text to fit had dropped the genre first, an owner-found bug ("how come so many songs are missing their genre and subgenre on the tracklist?"). OS's owner said "We can't have overlaps or overflows anywhere." about 9 times; OS's layout dump over about 70 screens at six resolutions went from 320 findings to 0 with an empty allowlist and found everything past x=1728 off screen at 16:10, but checked nothing for half a day because a backdrop at z-index -1 read as a modal. OS on framing: "no cut outs ... even fi they move".
|
|
125
|
+
- **Applies when:** Every game with a DOM or canvas-drawn interface.
|
|
126
|
+
- **Verify:** The audit is empty apart from named exceptions. Plant an overlap and a cut label: it fails on each. Capture every list row at five sizes.
|
|
127
|
+
|
|
83
128
|
### Say where, not what the folder is called
|
|
84
129
|
- **Invariant:** Every out-of-match surface names a place the way a player is sent there, and names it the same way everywhere.
|
|
85
130
|
- **Technique:** One table of places with their names and when they are, read by the menu, the loading screen and the results.
|
|
@@ -94,24 +139,24 @@ times; those rules come first.
|
|
|
94
139
|
- **Applies when:** Every game.
|
|
95
140
|
- **Verify:** Walk that whole loop by keyboard alone, twice, and check that nothing duplicated (loops, listeners, decoders) on the second pass.
|
|
96
141
|
|
|
97
|
-
### A HUD scaled from one unit
|
|
98
|
-
- **Invariant:** The HUD keeps its proportions at every screen size, numbers do not jitter as they change,
|
|
99
|
-
- **Technique:** Size every HUD element from one CSS unit derived from the viewport; tabular numerals on everything that counts; information on a safe inset at the edges; readability from shadow rather than panels; icons drawn per element at one stroke weight.
|
|
100
|
-
- **Reference configuration:** AW: `--u: min(0.0926vh, 0.0521vw)`, one 1080p pixel. SR: an edge inset of `clamp(14px, 2.4vw, 34px)`. Readability from a hard 1u shadow plus a soft 7u one, and bone (#ece7d8) instead of pure white. OC's sweep: 1280x720, 1920x1080, 2560x1440, 1024x768, 16:10, iPad and 844x390, where fixed-width panels clipped at 16:10.
|
|
142
|
+
### A HUD scaled from one unit, and sized once against a reference
|
|
143
|
+
- **Invariant:** The HUD keeps its proportions at every screen size, numbers do not jitter as they change, the centre of the screen stays clear, and its size is set against a reference frame or the owner's word and then offered as a setting, never moved back and forth by critic notes.
|
|
144
|
+
- **Technique:** Size every HUD element from one CSS unit derived from the viewport; tabular numerals on everything that counts; information on a safe inset at the edges; readability from shadow or a thin stroke rather than panels; icons drawn per element at one stroke weight; text written only when it changes. Measure each cluster's share of the frame against the reference frame once, record it, and offer a HUD-scale setting rather than resizing after each critique. The zero-HUD setting is in `opengame-accessibility`.
|
|
145
|
+
- **Reference configuration:** AW: `--u: min(0.0926vh, 0.0521vw)`, one 1080p pixel. LC sizes its console interface from `min(1vh, 0.5625vw)` and draws HUD text with a black stroke plus a shadow. SR: an edge inset of `clamp(14px, 2.4vw, 34px)`. Readability from a hard 1u shadow plus a soft 7u one, and bone (#ece7d8) instead of pure white. OC's sweep: 1280x720, 1920x1080, 2560x1440, 1024x768, 16:10, iPad and 844x390, where fixed-width panels clipped at 16:10; sized to its reference frame, OC's clusters take 13-15% of the width (see `opengame-quality-bar`). OS's HUD went from "way too big" to "so small" in one day, as one judge's "30-40% too big" was answered and the next said it had shrunk too far. LC writes HUD text only on change and holds a task-line change that only names a new place for 6 s: a 42-minute run's events had made 74 text changes for 21 steps, and now make 20.
|
|
101
146
|
- **Applies when:** Every game with a HUD.
|
|
102
|
-
- **Verify:** Capture the HUD at every desktop viewport
|
|
147
|
+
- **Verify:** Capture the HUD at every desktop viewport: the layout is the same picture at each size, a counting number does not shift its neighbours, and each cluster's share matches the recorded one.
|
|
103
148
|
|
|
104
149
|
### A hitmarker grammar
|
|
105
150
|
- **Invariant:** The player can tell a hit, a critical hit, a kill and incoming damage apart at a glance, and their direction.
|
|
106
151
|
- **Technique:** Distinct marks with distinct timing for hit, critical and kill, merged damage numbers per target, and a directional arc toward an attacker that decays.
|
|
107
|
-
- **Reference configuration:** MC and AW: four ticks; a hit 130 to 180 ms scaling 1.34 to 1; a headshot gold, 165 ms; a kill red and thicker, 240 to 340 ms. Hits on one target within 180 ms merge into one number rising 34 px over 900 ms. Incoming damage: a conic arc, attack 80 ms, hold 180 ms, decay 1350 ms.
|
|
152
|
+
- **Reference configuration:** MC and AW: four ticks; a hit 130 to 180 ms scaling 1.34 to 1; a headshot gold, 165 ms; a kill red and thicker, 240 to 340 ms. Hits on one target within 180 ms merge into one number rising 34 px over 900 ms. Incoming damage: a conic arc, attack 80 ms, hold 180 ms, decay 1350 ms. OS fires a hitmarker only on damage the resolver scored, after "im also getting too many hitmarkers... when i shoudlnt be".
|
|
108
153
|
- **Applies when:** Combat games.
|
|
109
154
|
- **Verify:** Frame-step a recording of a hit, a headshot and a kill; each mark is distinguishable on a single frame.
|
|
110
155
|
|
|
111
156
|
### Flashes are limited at the source
|
|
112
157
|
- **Invariant:** No effect, in the canvas or in the DOM over it, changes the screen's brightness fast enough to be a photosensitive flash, rising or falling.
|
|
113
158
|
- **Technique:** Limit the frame-to-frame change in composited luminance for full-screen effects, in both directions, by measuring every large overlay rather than a list of known ones. Injury overlays keep the centre clear.
|
|
114
|
-
- **Reference configuration:** AW limits each overlay's frame-to-frame luminance step to 0.045, under half of WCAG 2.3.1's 0.10 flash pair, after two players reported flashing violent enough to fear a seizure.
|
|
159
|
+
- **Reference configuration:** AW limits each overlay's frame-to-frame luminance step to 0.045, under half of WCAG 2.3.1's 0.10 flash pair, after two players reported flashing violent enough to fear a seizure. LC's hurt rim keeps at least three quarters of the frame clear.
|
|
115
160
|
- **Applies when:** Every game with flashes, damage overlays or explosions.
|
|
116
161
|
- **Verify:** Record the worst flash in the game and measure per-frame mean luminance; no step exceeds the limit. See `opengame-accessibility`.
|
|
117
162
|
|
|
@@ -123,11 +168,11 @@ times; those rules come first.
|
|
|
123
168
|
- **Verify:** Switch it on, reload: it is still on, and only in play. Load the machine until the rate drops below target: the counter turns yellow, not red.
|
|
124
169
|
|
|
125
170
|
### New interface is built from the game's own kit
|
|
126
|
-
- **Invariant:** Every dialog, badge, toast and card added later looks and sounds like the game's own menus.
|
|
127
|
-
- **Technique:** Build new UI from the menus' components, type, colours, hover and click sounds; flat, with no gradients, tints or shimmer; the same focus loop as other dialogs (Escape, outside tap, Tab, Enter); a form that closes confirms with the game's own toast.
|
|
128
|
-
- **Reference configuration:** OC's owner on a brand badge: "i hate the gradient... no orange tint. and make it look as sick as our menu components... same hover sfx and click sfx". The badge, the feedback dialog and its toast were rebuilt from the menu kit.
|
|
171
|
+
- **Invariant:** Every dialog, badge, toast and card added later looks and sounds like the game's own menus, from its first frame.
|
|
172
|
+
- **Technique:** Build new UI from the menus' components, type, colours, hover and click sounds; flat, with no gradients, tints or shimmer; the same focus loop as other dialogs (Escape, outside tap, Tab, Enter); a form that closes confirms with the game's own toast. Check an entrance animation frame by frame, because a timing contract can pass while the frames stay faded.
|
|
173
|
+
- **Reference configuration:** OC's owner on a brand badge: "i hate the gradient... no orange tint. and make it look as sick as our menu components... same hover sfx and click sfx". The badge, the feedback dialog and its toast were rebuilt from the menu kit. OS's perk medals took 6 asks ("we need it to look like the second frame asap"): a 220 ms entrance contract passed while the medal stayed faded.
|
|
129
174
|
- **Applies when:** Every game that adds web UI around or over the canvas.
|
|
130
|
-
- **Verify:** Capture the new dialog beside a menu in one frame: same type, colours and corners. Hover and click it with sound on.
|
|
175
|
+
- **Verify:** Capture the new dialog beside a menu in one frame: same type, colours and corners. Hover and click it with sound on. Step its first 300 ms frame by frame: it is whole by the frame the design says.
|
|
131
176
|
|
|
132
177
|
### The share card is a frame of the real game
|
|
133
178
|
- **Invariant:** The link preview, share card and icons come from the game as it plays, carry the game's mark and address, and show no counters, debug text or placeholders.
|
|
@@ -138,6 +183,7 @@ times; those rules come first.
|
|
|
138
183
|
|
|
139
184
|
## Further reading
|
|
140
185
|
|
|
141
|
-
Interface sound, controls legends and
|
|
142
|
-
[references/menus.md](references/menus.md). First-run
|
|
143
|
-
analytics for a game served from its own domain:
|
|
186
|
+
Interface sound, controls legends, pause in solo and online-styled games, pointer lock
|
|
187
|
+
traps and the menu audio path: [references/menus.md](references/menus.md). First-run
|
|
188
|
+
details, the share card and analytics for a game served from its own domain:
|
|
189
|
+
[references/launch.md](references/launch.md).
|
|
@@ -13,33 +13,67 @@
|
|
|
13
13
|
blocking the controls.
|
|
14
14
|
- A menu film's own soundtrack is the menu ambience. Never layer a second music bed under
|
|
15
15
|
it, and stop conflicting beds when moving between menu and play.
|
|
16
|
+
- Listen to the menu with nothing happening. OS's owner heard "footsteps" in a menu 4
|
|
17
|
+
times over 3 days; the third cause was an ambience bed generated from a prompt that said
|
|
18
|
+
"gravel crunching far away".
|
|
16
19
|
|
|
17
20
|
## Controls and the controls legend
|
|
18
21
|
|
|
19
|
-
- One action table drives input handling, HUD hints, menu help
|
|
20
|
-
can never disagree with the keys.
|
|
22
|
+
- One action table drives input handling, HUD hints, menu help, the remapping screen and
|
|
23
|
+
playtests, so a legend can never disagree with the keys.
|
|
21
24
|
- Desktop shooter defaults (ST): WASD to move, mouse to look, left click to fire, right
|
|
22
25
|
click to hold aim and E to toggle it, Space to jump, Shift to sprint, C to crouch, F to
|
|
23
26
|
interact, R to reload, Q to cycle weapons, number keys for weapon slots, Escape to pause.
|
|
24
27
|
Use the bindings for mechanics the game has; genre conventions and the creator's choices
|
|
25
|
-
win.
|
|
28
|
+
win. LC keeps E as a second aim key for laptop players without a mouse.
|
|
29
|
+
- Never bind a held action to Ctrl: Ctrl+W closes the tab (OS crouch).
|
|
26
30
|
- Holding aim still allows firing. Track mouse buttons with per-button events or the
|
|
27
31
|
buttons bitmask; `pointerdown` alone misses a second button pressed while one is held.
|
|
28
32
|
- Clear held keys and aim on pause, blur, death and restart. Ignore key repeat and text
|
|
29
33
|
fields.
|
|
30
|
-
-
|
|
34
|
+
- A word in a quick note is not a spec: OS's owner wrote "Hold F" and meant press. Ask, or
|
|
35
|
+
build the press and say so.
|
|
36
|
+
- Every control is remappable (see `opengame-accessibility`), and a rebind that takes a
|
|
37
|
+
held key swaps the two actions.
|
|
31
38
|
|
|
32
39
|
## Pause
|
|
33
40
|
|
|
34
|
-
|
|
35
|
-
with a fresh time baseline. A pointer-lock refusal lands on a usable menu.
|
|
36
|
-
|
|
41
|
+
A solo game's pause stops simulation, enemies, scoring and timers together. Resume
|
|
42
|
+
explicitly with a fresh time baseline. A pointer-lock refusal lands on a usable menu.
|
|
43
|
+
|
|
44
|
+
A game presented as online, with bots standing in for players, never pauses: the menu is
|
|
45
|
+
an overlay that captures input while the match, its timers, killcams and spawns go on and
|
|
46
|
+
world audio carries on ducked. OS's owner asked for this six times.
|
|
47
|
+
|
|
48
|
+
Safari and Firefox spend Escape on leaving fullscreen, and a host page or a fullscreen
|
|
49
|
+
browser can take Escape too, so pause has a second key (OH uses P beside Esc).
|
|
50
|
+
|
|
51
|
+
## Pointer lock and fullscreen
|
|
52
|
+
|
|
53
|
+
- Request the lock inside the handler of the press that starts play, then fullscreen only
|
|
54
|
+
after `pointerlockchange`; fullscreen first spends the user activation and the lock is
|
|
55
|
+
refused (OS). Inside OpenGame's frame `requestFullscreen` fails: the page owns
|
|
56
|
+
fullscreen, and a game's own button calls `og.fullscreen.request()` (`opengame-sdk`).
|
|
57
|
+
- One owner holds the lock state and confirms a held lock instead of asking again; a
|
|
58
|
+
second request dropped a held lock in 1 of 7 OS tours.
|
|
59
|
+
- Browsers refuse a lock requested from an Escape keydown.
|
|
60
|
+
- Headless browsers refuse pointer lock until one real click, and headless Chromium sends
|
|
61
|
+
a spurious mouse move of about (-960, -540) right after a lock lands (OS). Stage test
|
|
62
|
+
cameras with the game's own switches rather than mouse moves.
|
|
63
|
+
- Scripted calls into the page are granted user activation, so they never reach the
|
|
64
|
+
refusal paths; test those with a real click (LC).
|
|
37
65
|
|
|
38
66
|
## Reflow
|
|
39
67
|
|
|
40
68
|
Menus reflow at narrow widths and at 200% zoom without clipped actions or horizontal
|
|
41
69
|
scrolling, and touch targets are comfortably sized. Responsive menus do not make a game
|
|
42
|
-
playable by touch; say so if it is not.
|
|
70
|
+
playable by touch; say so if it is not (see `opengame-mobile`).
|
|
71
|
+
|
|
72
|
+
## Characters in menus
|
|
73
|
+
|
|
74
|
+
No character is cut by a frame edge, even while it moves; fade it out before any image
|
|
75
|
+
edge (OS: "no cut outs ... even fi they move"). A character card is ready only when this
|
|
76
|
+
subject is drawn on this visit, not when an earlier one was.
|
|
43
77
|
|
|
44
78
|
## Credits
|
|
45
79
|
|