@opengamehq/skills 1.3.0 → 1.5.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +44 -0
- package/README.md +12 -4
- package/dist/.claude-plugin/marketplace.json +26 -0
- package/dist/skills/manifest.json +1409 -145
- package/dist/skills/opengame-accessibility/CHANGELOG.md +4 -0
- package/dist/skills/opengame-accessibility/SKILL.md +48 -32
- package/dist/skills/opengame-all-in-one/CHANGELOG.md +21 -0
- package/dist/skills/opengame-all-in-one/SKILL.md +195 -0
- package/dist/skills/opengame-all-in-one/references/opengame-accessibility/README.md +102 -0
- package/dist/skills/opengame-all-in-one/references/opengame-api/README.md +107 -0
- package/dist/skills/opengame-all-in-one/references/opengame-assets/README.md +168 -0
- package/dist/skills/opengame-all-in-one/references/opengame-assets/references/pipeline.md +164 -0
- package/dist/skills/opengame-all-in-one/references/opengame-audio/README.md +238 -0
- package/dist/skills/opengame-all-in-one/references/opengame-audio/helpers/audio-chain.js +325 -0
- package/dist/skills/opengame-all-in-one/references/opengame-audio/references/mix-notes.md +125 -0
- package/dist/skills/opengame-all-in-one/references/opengame-audio/references/qa-without-ears.md +177 -0
- package/dist/skills/opengame-all-in-one/references/opengame-capture/README.md +128 -0
- package/dist/skills/opengame-all-in-one/references/opengame-capture/references/pipeline.md +114 -0
- package/dist/skills/opengame-all-in-one/references/opengame-capture/references/threejs.md +161 -0
- package/dist/skills/opengame-all-in-one/references/opengame-characters/README.md +180 -0
- package/dist/skills/opengame-all-in-one/references/opengame-characters/references/first-person-body.md +108 -0
- package/dist/skills/opengame-all-in-one/references/opengame-characters/references/integration.md +144 -0
- package/dist/skills/opengame-all-in-one/references/opengame-characters/references/player-og.md +160 -0
- package/dist/skills/opengame-all-in-one/references/opengame-cli/README.md +189 -0
- package/dist/skills/opengame-all-in-one/references/opengame-deploy/README.md +223 -0
- package/dist/skills/opengame-all-in-one/references/opengame-deploy/references/json-events.md +63 -0
- package/dist/skills/opengame-all-in-one/references/opengame-deploy/references/manifest.md +89 -0
- package/dist/skills/opengame-all-in-one/references/opengame-deploy/references/packaging.md +119 -0
- package/dist/skills/opengame-all-in-one/references/opengame-depth/README.md +154 -0
- package/dist/skills/opengame-all-in-one/references/opengame-enemies/README.md +155 -0
- package/dist/skills/opengame-all-in-one/references/opengame-enemies/references/pacing-and-bots.md +108 -0
- package/dist/skills/opengame-all-in-one/references/opengame-enemies/references/threejs.md +193 -0
- package/dist/skills/opengame-all-in-one/references/opengame-front-end/README.md +185 -0
- package/dist/skills/opengame-all-in-one/references/opengame-front-end/references/launch.md +50 -0
- package/dist/skills/opengame-all-in-one/references/opengame-front-end/references/menus.md +81 -0
- package/dist/skills/opengame-all-in-one/references/opengame-game-feel/README.md +181 -0
- package/dist/skills/opengame-all-in-one/references/opengame-game-feel/helpers/spring.js +146 -0
- package/dist/skills/opengame-all-in-one/references/opengame-game-feel/references/feel-numbers.md +142 -0
- package/dist/skills/opengame-all-in-one/references/opengame-game-feel/references/killcam.md +88 -0
- package/dist/skills/opengame-all-in-one/references/opengame-jam/README.md +114 -0
- package/dist/skills/opengame-all-in-one/references/opengame-lighting/README.md +141 -0
- package/dist/skills/opengame-all-in-one/references/opengame-lighting/helpers/light-pool.js +185 -0
- package/dist/skills/opengame-all-in-one/references/opengame-loading/README.md +135 -0
- package/dist/skills/opengame-all-in-one/references/opengame-loading/helpers/loading-count.mjs +115 -0
- package/dist/skills/opengame-all-in-one/references/opengame-loading/references/threejs.md +141 -0
- package/dist/skills/opengame-all-in-one/references/opengame-look/README.md +181 -0
- package/dist/skills/opengame-all-in-one/references/opengame-look/references/matching-a-reference.md +73 -0
- package/dist/skills/opengame-all-in-one/references/opengame-look/references/painterly.md +69 -0
- package/dist/skills/opengame-all-in-one/references/opengame-look/references/post-and-lens.md +73 -0
- package/dist/skills/opengame-all-in-one/references/opengame-maps/README.md +74 -0
- package/dist/skills/opengame-all-in-one/references/opengame-maps/references/map-spec.md +77 -0
- package/dist/skills/opengame-all-in-one/references/opengame-mobile/README.md +86 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/README.md +183 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/briefs.md +293 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/day-one-questions.md +46 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/edge-cases.md +27 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/filmable.md +244 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/finishing.md +126 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/measure.md +282 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-capture.md +151 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-gates.md +84 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-genres.md +198 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-grammar.md +320 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-ops.md +127 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/og-snipers-record.md +110 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/owner-eye.md +214 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/reference-study.md +293 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/song.md +64 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/README.md +193 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/briefs.md +293 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/day-one-questions.md +46 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/filmable.md +244 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/measure.md +282 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-capture.md +151 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-gates.md +84 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-genres.md +198 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-grammar.md +320 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-ops.md +127 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/og-snipers-record.md +110 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/owner-eye.md +214 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/reference-study.md +293 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/song.md +64 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/README.md +174 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/briefs.md +293 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/day-one-questions.md +46 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/filmable.md +244 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/finishing.md +126 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/measure.md +282 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-capture.md +151 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-gates.md +84 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-genres.md +198 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-grammar.md +320 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-ops.md +127 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/og-snipers-record.md +110 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/owner-eye.md +214 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/reference-study.md +293 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/song.md +64 -0
- package/dist/skills/opengame-all-in-one/references/opengame-multiplayer/README.md +139 -0
- package/dist/skills/opengame-all-in-one/references/opengame-multiplayer/references/bot-lobbies.md +71 -0
- package/dist/skills/opengame-all-in-one/references/opengame-multiplayer/references/netcode.md +165 -0
- package/dist/skills/opengame-all-in-one/references/opengame-performance/README.md +177 -0
- package/dist/skills/opengame-all-in-one/references/opengame-performance/helpers/landing-pacer.mjs +86 -0
- package/dist/skills/opengame-all-in-one/references/opengame-performance/references/measuring.md +123 -0
- package/dist/skills/opengame-all-in-one/references/opengame-performance/references/webgpu.md +86 -0
- package/dist/skills/opengame-all-in-one/references/opengame-production/README.md +192 -0
- package/dist/skills/opengame-all-in-one/references/opengame-production/references/team.md +107 -0
- package/dist/skills/opengame-all-in-one/references/opengame-production/references/templates.md +153 -0
- package/dist/skills/opengame-all-in-one/references/opengame-quality-bar/README.md +170 -0
- package/dist/skills/opengame-all-in-one/references/opengame-quality-bar/references/cheap-tells.md +43 -0
- package/dist/skills/opengame-all-in-one/references/opengame-quality-bar/references/judges.md +95 -0
- package/dist/skills/opengame-all-in-one/references/opengame-quality-bar/references/review-prompt.md +32 -0
- package/dist/skills/opengame-all-in-one/references/opengame-rhythm/README.md +134 -0
- package/dist/skills/opengame-all-in-one/references/opengame-rhythm/references/charting.md +109 -0
- package/dist/skills/opengame-all-in-one/references/opengame-rhythm/references/timing.md +92 -0
- package/dist/skills/opengame-all-in-one/references/opengame-router/README.md +54 -0
- package/dist/skills/opengame-all-in-one/references/opengame-router/references/process.md +38 -0
- package/dist/skills/opengame-all-in-one/references/opengame-scene-audit/README.md +136 -0
- package/dist/skills/opengame-all-in-one/references/opengame-scene-audit/helpers/scene-audit.js +677 -0
- package/dist/skills/opengame-all-in-one/references/opengame-sdk/README.md +283 -0
- package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/engines.md +93 -0
- package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/frame.md +107 -0
- package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/identity.md +111 -0
- package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/leaderboards.md +115 -0
- package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/radio.md +71 -0
- package/dist/skills/opengame-all-in-one/references/opengame-stability/README.md +112 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/README.md +160 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/archetypes.md +113 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/briefs.md +273 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/core.md +129 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/craft.md +299 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/edge-cases.md +27 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/filmable.md +244 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/finishing.md +126 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/gates.md +184 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/measure.md +282 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/music.md +148 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/og-clash-record.md +133 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/ops.md +154 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/owner-eye.md +214 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/review.md +141 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/title.md +92 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/README.md +172 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/archetypes.md +113 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/briefs.md +273 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/core.md +129 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/craft.md +299 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/edge-cases.md +27 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/filmable.md +244 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/finishing.md +126 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/gates.md +184 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/measure.md +282 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/music.md +148 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/og-clash-record.md +133 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/ops.md +154 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/owner-eye.md +214 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/reference-set.md +92 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/review.md +141 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/title.md +92 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/README.md +141 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/archetypes.md +113 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/briefs.md +273 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/core.md +129 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/craft.md +299 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/edge-cases.md +27 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/filmable.md +244 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/finishing.md +126 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/gates.md +184 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/measure.md +282 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/music.md +148 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/og-clash-record.md +133 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/ops.md +154 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/owner-eye.md +214 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/review.md +141 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/title.md +92 -0
- package/dist/skills/opengame-all-in-one/references/opengame-verification/README.md +197 -0
- package/dist/skills/opengame-all-in-one/references/opengame-verification/helpers/browser-evidence.mjs +74 -0
- package/dist/skills/opengame-all-in-one/references/opengame-weapons/README.md +179 -0
- package/dist/skills/opengame-all-in-one/references/opengame-weapons/references/handling-numbers.md +114 -0
- package/dist/skills/opengame-all-in-one/references/opengame-weapons/references/reloads-and-hands.md +96 -0
- package/dist/skills/opengame-all-in-one/references/opengame-weapons/references/sights-and-scopes.md +98 -0
- package/dist/skills/opengame-all-in-one/references/opengame-weapons/references/threejs.md +240 -0
- package/dist/skills/opengame-all-in-one/references/opengame-world-physics/README.md +141 -0
- package/dist/skills/opengame-all-in-one/references/opengame-world-physics/references/measured-failures.md +79 -0
- package/dist/skills/opengame-api/CHANGELOG.md +12 -0
- package/dist/skills/opengame-api/SKILL.md +39 -13
- package/dist/skills/opengame-assets/CHANGELOG.md +11 -0
- package/dist/skills/opengame-assets/SKILL.md +79 -31
- package/dist/skills/opengame-assets/references/pipeline.md +67 -0
- package/dist/skills/opengame-audio/CHANGELOG.md +11 -0
- package/dist/skills/opengame-audio/SKILL.md +129 -41
- package/dist/skills/opengame-audio/references/mix-notes.md +44 -1
- package/dist/skills/opengame-audio/references/qa-without-ears.md +177 -0
- package/dist/skills/opengame-capture/CHANGELOG.md +10 -0
- package/dist/skills/opengame-capture/SKILL.md +44 -20
- package/dist/skills/opengame-capture/references/pipeline.md +33 -1
- package/dist/skills/opengame-capture/references/threejs.md +17 -1
- package/dist/skills/opengame-characters/CHANGELOG.md +15 -0
- package/dist/skills/opengame-characters/SKILL.md +94 -39
- package/dist/skills/opengame-characters/references/first-person-body.md +108 -0
- package/dist/skills/opengame-characters/references/player-og.md +1 -1
- package/dist/skills/opengame-cli/CHANGELOG.md +20 -0
- package/dist/skills/opengame-cli/SKILL.md +12 -11
- package/dist/skills/opengame-deploy/CHANGELOG.md +30 -0
- package/dist/skills/opengame-deploy/SKILL.md +43 -23
- package/dist/skills/opengame-deploy/references/json-events.md +6 -5
- package/dist/skills/opengame-deploy/references/manifest.md +9 -3
- package/dist/skills/opengame-deploy/references/packaging.md +32 -30
- package/dist/skills/opengame-depth/CHANGELOG.md +8 -0
- package/dist/skills/opengame-depth/SKILL.md +61 -33
- package/dist/skills/opengame-enemies/CHANGELOG.md +10 -0
- package/dist/skills/opengame-enemies/SKILL.md +96 -40
- package/dist/skills/opengame-enemies/references/pacing-and-bots.md +108 -0
- package/dist/skills/opengame-enemies/references/threejs.md +59 -0
- package/dist/skills/opengame-front-end/CHANGELOG.md +4 -0
- package/dist/skills/opengame-front-end/SKILL.md +85 -39
- package/dist/skills/opengame-front-end/references/menus.md +42 -8
- package/dist/skills/opengame-game-feel/CHANGELOG.md +11 -0
- package/dist/skills/opengame-game-feel/SKILL.md +95 -47
- package/dist/skills/opengame-game-feel/references/feel-numbers.md +59 -0
- package/dist/skills/opengame-game-feel/references/killcam.md +88 -0
- package/dist/skills/opengame-jam/CHANGELOG.md +12 -0
- package/dist/skills/opengame-jam/SKILL.md +48 -33
- package/dist/skills/opengame-lighting/CHANGELOG.md +9 -0
- package/dist/skills/opengame-lighting/SKILL.md +85 -34
- package/dist/skills/opengame-loading/CHANGELOG.md +4 -0
- package/dist/skills/opengame-loading/SKILL.md +78 -38
- package/dist/skills/opengame-loading/helpers/loading-count.mjs +115 -0
- package/dist/skills/opengame-loading/references/threejs.md +32 -7
- package/dist/skills/opengame-look/CHANGELOG.md +9 -0
- package/dist/skills/opengame-look/SKILL.md +122 -51
- package/dist/skills/opengame-look/references/matching-a-reference.md +73 -0
- package/dist/skills/opengame-look/references/painterly.md +69 -0
- package/dist/skills/opengame-look/references/post-and-lens.md +10 -3
- package/dist/skills/opengame-maps/CHANGELOG.md +9 -0
- package/dist/skills/opengame-maps/SKILL.md +78 -0
- package/dist/skills/opengame-maps/references/map-spec.md +77 -0
- package/dist/skills/opengame-mobile/CHANGELOG.md +4 -0
- package/dist/skills/opengame-mobile/SKILL.md +18 -18
- package/dist/skills/opengame-montage-make/CHANGELOG.md +5 -0
- package/dist/skills/opengame-montage-make/SKILL.md +187 -0
- package/dist/skills/opengame-montage-make/references/briefs.md +293 -0
- package/dist/skills/opengame-montage-make/references/day-one-questions.md +46 -0
- package/dist/skills/opengame-montage-make/references/edge-cases.md +27 -0
- package/dist/skills/opengame-montage-make/references/filmable.md +244 -0
- package/dist/skills/opengame-montage-make/references/finishing.md +126 -0
- package/dist/skills/opengame-montage-make/references/measure.md +282 -0
- package/dist/skills/opengame-montage-make/references/montage-capture.md +151 -0
- package/dist/skills/opengame-montage-make/references/montage-gates.md +84 -0
- package/dist/skills/opengame-montage-make/references/montage-genres.md +198 -0
- package/dist/skills/opengame-montage-make/references/montage-grammar.md +320 -0
- package/dist/skills/opengame-montage-make/references/montage-ops.md +127 -0
- package/dist/skills/opengame-montage-make/references/og-snipers-record.md +110 -0
- package/dist/skills/opengame-montage-make/references/owner-eye.md +214 -0
- package/dist/skills/opengame-montage-make/references/reference-study.md +293 -0
- package/dist/skills/opengame-montage-make/references/song.md +64 -0
- package/dist/skills/opengame-montage-plan/CHANGELOG.md +5 -0
- package/dist/skills/opengame-montage-plan/SKILL.md +197 -0
- package/dist/skills/opengame-montage-plan/references/briefs.md +293 -0
- package/dist/skills/opengame-montage-plan/references/day-one-questions.md +46 -0
- package/dist/skills/opengame-montage-plan/references/filmable.md +244 -0
- package/dist/skills/opengame-montage-plan/references/measure.md +282 -0
- package/dist/skills/opengame-montage-plan/references/montage-capture.md +151 -0
- package/dist/skills/opengame-montage-plan/references/montage-gates.md +84 -0
- package/dist/skills/opengame-montage-plan/references/montage-genres.md +198 -0
- package/dist/skills/opengame-montage-plan/references/montage-grammar.md +320 -0
- package/dist/skills/opengame-montage-plan/references/montage-ops.md +127 -0
- package/dist/skills/opengame-montage-plan/references/og-snipers-record.md +110 -0
- package/dist/skills/opengame-montage-plan/references/owner-eye.md +214 -0
- package/dist/skills/opengame-montage-plan/references/reference-study.md +293 -0
- package/dist/skills/opengame-montage-plan/references/song.md +64 -0
- package/dist/skills/opengame-montage-review-and-improve/CHANGELOG.md +5 -0
- package/dist/skills/opengame-montage-review-and-improve/SKILL.md +178 -0
- package/dist/skills/opengame-montage-review-and-improve/references/briefs.md +293 -0
- package/dist/skills/opengame-montage-review-and-improve/references/day-one-questions.md +46 -0
- package/dist/skills/opengame-montage-review-and-improve/references/filmable.md +244 -0
- package/dist/skills/opengame-montage-review-and-improve/references/finishing.md +126 -0
- package/dist/skills/opengame-montage-review-and-improve/references/measure.md +282 -0
- package/dist/skills/opengame-montage-review-and-improve/references/montage-capture.md +151 -0
- package/dist/skills/opengame-montage-review-and-improve/references/montage-gates.md +84 -0
- package/dist/skills/opengame-montage-review-and-improve/references/montage-genres.md +198 -0
- package/dist/skills/opengame-montage-review-and-improve/references/montage-grammar.md +320 -0
- package/dist/skills/opengame-montage-review-and-improve/references/montage-ops.md +127 -0
- package/dist/skills/opengame-montage-review-and-improve/references/og-snipers-record.md +110 -0
- package/dist/skills/opengame-montage-review-and-improve/references/owner-eye.md +214 -0
- package/dist/skills/opengame-montage-review-and-improve/references/reference-study.md +293 -0
- package/dist/skills/opengame-montage-review-and-improve/references/song.md +64 -0
- package/dist/skills/opengame-multiplayer/CHANGELOG.md +15 -0
- package/dist/skills/opengame-multiplayer/SKILL.md +143 -0
- package/dist/skills/opengame-multiplayer/references/bot-lobbies.md +71 -0
- package/dist/skills/opengame-multiplayer/references/netcode.md +165 -0
- package/dist/skills/opengame-performance/CHANGELOG.md +8 -0
- package/dist/skills/opengame-performance/SKILL.md +106 -65
- package/dist/skills/opengame-performance/helpers/landing-pacer.mjs +86 -0
- package/dist/skills/opengame-performance/references/measuring.md +51 -0
- package/dist/skills/opengame-performance/references/webgpu.md +86 -0
- package/dist/skills/opengame-production/CHANGELOG.md +13 -0
- package/dist/skills/opengame-production/SKILL.md +119 -54
- package/dist/skills/opengame-production/references/team.md +107 -0
- package/dist/skills/opengame-production/references/templates.md +106 -16
- package/dist/skills/opengame-quality-bar/CHANGELOG.md +10 -0
- package/dist/skills/opengame-quality-bar/SKILL.md +94 -42
- package/dist/skills/opengame-quality-bar/references/cheap-tells.md +14 -7
- package/dist/skills/opengame-quality-bar/references/judges.md +95 -0
- package/dist/skills/opengame-quality-bar/references/review-prompt.md +10 -5
- package/dist/skills/opengame-rhythm/CHANGELOG.md +5 -0
- package/dist/skills/opengame-rhythm/SKILL.md +138 -0
- package/dist/skills/opengame-rhythm/references/charting.md +109 -0
- package/dist/skills/opengame-rhythm/references/timing.md +92 -0
- package/dist/skills/opengame-router/CHANGELOG.md +12 -0
- package/dist/skills/opengame-router/SKILL.md +14 -7
- package/dist/skills/opengame-scene-audit/CHANGELOG.md +15 -0
- package/dist/skills/opengame-scene-audit/SKILL.md +64 -47
- package/dist/skills/opengame-scene-audit/helpers/scene-audit.js +97 -19
- package/dist/skills/opengame-sdk/CHANGELOG.md +16 -0
- package/dist/skills/opengame-sdk/SKILL.md +27 -10
- package/dist/skills/opengame-sdk/references/engines.md +2 -2
- package/dist/skills/opengame-sdk/references/identity.md +10 -11
- package/dist/skills/opengame-sdk/references/leaderboards.md +11 -1
- package/dist/skills/opengame-sdk/references/radio.md +1 -1
- package/dist/skills/opengame-stability/CHANGELOG.md +4 -0
- package/dist/skills/opengame-stability/SKILL.md +59 -27
- package/dist/skills/opengame-trailer-make/CHANGELOG.md +5 -0
- package/dist/skills/opengame-trailer-make/SKILL.md +164 -0
- package/dist/skills/opengame-trailer-make/references/archetypes.md +113 -0
- package/dist/skills/opengame-trailer-make/references/briefs.md +273 -0
- package/dist/skills/opengame-trailer-make/references/core.md +129 -0
- package/dist/skills/opengame-trailer-make/references/craft.md +299 -0
- package/dist/skills/opengame-trailer-make/references/edge-cases.md +27 -0
- package/dist/skills/opengame-trailer-make/references/filmable.md +244 -0
- package/dist/skills/opengame-trailer-make/references/finishing.md +126 -0
- package/dist/skills/opengame-trailer-make/references/gates.md +184 -0
- package/dist/skills/opengame-trailer-make/references/measure.md +282 -0
- package/dist/skills/opengame-trailer-make/references/music.md +148 -0
- package/dist/skills/opengame-trailer-make/references/og-clash-record.md +133 -0
- package/dist/skills/opengame-trailer-make/references/ops.md +154 -0
- package/dist/skills/opengame-trailer-make/references/owner-eye.md +214 -0
- package/dist/skills/opengame-trailer-make/references/review.md +141 -0
- package/dist/skills/opengame-trailer-make/references/title.md +92 -0
- package/dist/skills/opengame-trailer-plan/CHANGELOG.md +5 -0
- package/dist/skills/opengame-trailer-plan/SKILL.md +176 -0
- package/dist/skills/opengame-trailer-plan/references/archetypes.md +113 -0
- package/dist/skills/opengame-trailer-plan/references/briefs.md +273 -0
- package/dist/skills/opengame-trailer-plan/references/core.md +129 -0
- package/dist/skills/opengame-trailer-plan/references/craft.md +299 -0
- package/dist/skills/opengame-trailer-plan/references/edge-cases.md +27 -0
- package/dist/skills/opengame-trailer-plan/references/filmable.md +244 -0
- package/dist/skills/opengame-trailer-plan/references/finishing.md +126 -0
- package/dist/skills/opengame-trailer-plan/references/gates.md +184 -0
- package/dist/skills/opengame-trailer-plan/references/measure.md +282 -0
- package/dist/skills/opengame-trailer-plan/references/music.md +148 -0
- package/dist/skills/opengame-trailer-plan/references/og-clash-record.md +133 -0
- package/dist/skills/opengame-trailer-plan/references/ops.md +154 -0
- package/dist/skills/opengame-trailer-plan/references/owner-eye.md +214 -0
- package/dist/skills/opengame-trailer-plan/references/reference-set.md +92 -0
- package/dist/skills/opengame-trailer-plan/references/review.md +141 -0
- package/dist/skills/opengame-trailer-plan/references/title.md +92 -0
- package/dist/skills/opengame-trailer-review-and-improve/CHANGELOG.md +5 -0
- package/dist/skills/opengame-trailer-review-and-improve/SKILL.md +145 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/archetypes.md +113 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/briefs.md +273 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/core.md +129 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/craft.md +299 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/edge-cases.md +27 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/filmable.md +244 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/finishing.md +126 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/gates.md +184 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/measure.md +282 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/music.md +148 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/og-clash-record.md +133 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/ops.md +154 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/owner-eye.md +214 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/review.md +141 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/title.md +92 -0
- package/dist/skills/opengame-verification/CHANGELOG.md +11 -0
- package/dist/skills/opengame-verification/SKILL.md +113 -48
- package/dist/skills/opengame-weapons/CHANGELOG.md +11 -0
- package/dist/skills/opengame-weapons/SKILL.md +129 -55
- package/dist/skills/opengame-weapons/references/handling-numbers.md +42 -0
- package/dist/skills/opengame-weapons/references/reloads-and-hands.md +96 -0
- package/dist/skills/opengame-weapons/references/sights-and-scopes.md +98 -0
- package/dist/skills/opengame-weapons/references/threejs.md +71 -0
- package/dist/skills/opengame-world-physics/CHANGELOG.md +9 -0
- package/dist/skills/opengame-world-physics/SKILL.md +55 -24
- package/dist/skills/opengame-world-physics/references/measured-failures.md +28 -1
- package/package.json +1 -1
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
# opengame.json
|
|
2
|
+
|
|
3
|
+
The game's manifest, committed with its code. `opengame init` writes it; the website
|
|
4
|
+
edits the same fields. The game's id is never in this file: it lives in
|
|
5
|
+
`.opengame/project.json`, which is git-ignored, so a fork never deploys over somebody
|
|
6
|
+
else's game. Jam answers (track, certification) are never stored here either, because
|
|
7
|
+
they belong to one entry, not to the game.
|
|
8
|
+
|
|
9
|
+
```json
|
|
10
|
+
{
|
|
11
|
+
"$schema": "https://opengame.io/schema/opengame.json",
|
|
12
|
+
"title": "Night shift",
|
|
13
|
+
"description": "Survive until dawn with a torch and a dwindling battery.",
|
|
14
|
+
"genre": "shooter-survival",
|
|
15
|
+
"kind": "game",
|
|
16
|
+
"build": { "command": "npm run build", "output": "dist" },
|
|
17
|
+
"controls": ["keyboard", "mouse"],
|
|
18
|
+
"leaderboards": [{ "key": "rounds", "order": "desc", "label": "Rounds survived", "min": 0, "max": 75 }]
|
|
19
|
+
}
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
| Field | Rule |
|
|
23
|
+
| --- | --- |
|
|
24
|
+
| `title` | 3 to 40 characters |
|
|
25
|
+
| `tagline` | Optional, up to 140 characters |
|
|
26
|
+
| `description` | 40 to 500 characters. Say what the player does |
|
|
27
|
+
| `genre` | Exactly one slug from the table below |
|
|
28
|
+
| `kind` | Optional. One of the four kinds below; leaving it out means `game`. `opengame init` always writes it |
|
|
29
|
+
| `basedOn` | The name of the game a `decomp` or a `mod` is made from, up to 60 characters, shown as "Mod of Doom". Required for a `decomp` or a `mod`, and not allowed for a `game` or a `world` |
|
|
30
|
+
| `build.command` | Optional, up to 1,000 characters. Run before checking; may read environment variables but must not contain a secret |
|
|
31
|
+
| `build.output` | The folder holding `index.html` after the build, or `.` |
|
|
32
|
+
| `cover` | Not used. OpenGame makes the cover after approval. A file that still names one passes `check`, and the CLI does not upload it; leave the field out |
|
|
33
|
+
| `controls` | One or more of `keyboard`, `mouse`, `gamepad`, each once |
|
|
34
|
+
| `requires` | Optional. `threads: true` for a build that cannot start without them, `renderer` (`webgl`, `webgl2` or `webgpu`), `desktopOnly`, `gamepad`. The game page lists them, and a browser that cannot run threads is told so instead of getting a black frame |
|
|
35
|
+
| `leaderboards` | Up to 25 boards: `key` (lowercase, starts with a letter, up to 48 characters), `order` (`asc` or `desc`), `label` (up to 60 characters), optional `min` and `max` |
|
|
36
|
+
| `achievements` | Up to 100: `id` (lowercase letters, digits, `-` and `_`, up to 48 characters), `title`, optional `description`. A deploy saves them when its preview is ready |
|
|
37
|
+
| `sdk` | Optional. A version string, or `{ "inject": false, "version": "..." }`. `inject: false` is honoured only on the older contract whose serving tree the pipeline rewrites; the contracts that add `/_og/sdk.js` at the edge always add it |
|
|
38
|
+
| `runtimes` | Optional. Settings for a runtime the platform serves pinned (js-dos, Ruffle, Pyodide, wasmoon, Flutter's CanvasKit); the engine's guide says which |
|
|
39
|
+
|
|
40
|
+
Write the title and description from the game itself. Read the code, play it if you
|
|
41
|
+
can, and describe what is there. A description that promises modes the game does not
|
|
42
|
+
have is a review finding.
|
|
43
|
+
|
|
44
|
+
## Genres
|
|
45
|
+
|
|
46
|
+
| Slug | Genre |
|
|
47
|
+
| --- | --- |
|
|
48
|
+
| `shooter-survival` | Shooter & survival |
|
|
49
|
+
| `action-adventure` | Action & adventure |
|
|
50
|
+
| `rpg` | RPG |
|
|
51
|
+
| `platformer` | Platformer |
|
|
52
|
+
| `strategy` | Strategy |
|
|
53
|
+
| `simulation-management` | Simulation & management |
|
|
54
|
+
| `racing-sports` | Racing & sports |
|
|
55
|
+
| `fighting` | Fighting |
|
|
56
|
+
| `puzzle-casual` | Puzzle & casual |
|
|
57
|
+
| `party-social-sandbox` | Party, social & sandbox |
|
|
58
|
+
|
|
59
|
+
## Kinds
|
|
60
|
+
|
|
61
|
+
Ask the person which one it is rather than guessing from the code. A mod or a decomp is
|
|
62
|
+
made from someone else's game, which is a fact about where it came from, not about how
|
|
63
|
+
it plays.
|
|
64
|
+
|
|
65
|
+
| Kind | What it is | `basedOn` | Can enter the jam |
|
|
66
|
+
| --- | --- | --- | --- |
|
|
67
|
+
| `game` | Something to play, with goals, rules or a way to win | Not allowed | Yes |
|
|
68
|
+
| `world` | A place to explore or hang out in, with nothing you have to win | Not allowed | Yes |
|
|
69
|
+
| `decomp` | An existing game rebuilt from its decompiled code | Required | No |
|
|
70
|
+
| `mod` | Changes to an existing game, like new levels, rules or art | Required | No |
|
|
71
|
+
|
|
72
|
+
`opengame init --kind mod --based-on "Doom"` writes both. Without `--kind`, init makes a
|
|
73
|
+
game; it asks a person nothing but the game's name.
|
|
74
|
+
|
|
75
|
+
A folder with no description of its own gets a placeholder sentence, which the deploy marks
|
|
76
|
+
provisional, and so does a genre init could not read from the game's words. Do not ask the
|
|
77
|
+
creator for either before deploying: the deploy's page asks them, and `opengame details
|
|
78
|
+
--description` sets the description from here once the game exists. A game cannot publish
|
|
79
|
+
with the placeholder.
|
|
80
|
+
|
|
81
|
+
## Who owns which value
|
|
82
|
+
|
|
83
|
+
Metadata on the server has revisions. A deploy sends the manifest with the revision it
|
|
84
|
+
was last synced from. If the website is newer, the deploy keeps the website's values
|
|
85
|
+
and says which fields it kept. `kind` and `basedOn` are among those fields: a reviewer
|
|
86
|
+
can correct a kind on the website, and a pull brings the correction down. `opengame pull` writes the website's values into this
|
|
87
|
+
file, backing up the previous one in `.opengame/manifest-before-pull.json`.
|
|
88
|
+
`opengame deploy --metadata=local` replaces the website's values on purpose; use it
|
|
89
|
+
only when the person asked for that.
|
|
@@ -0,0 +1,119 @@
|
|
|
1
|
+
# The packaging contract
|
|
2
|
+
|
|
3
|
+
Every number here is read from the platform's own limits when this skill is built, so
|
|
4
|
+
it matches what the CLI and the server enforce. The canonical contract for agents is
|
|
5
|
+
also published at opengame.io/agent.md.
|
|
6
|
+
|
|
7
|
+
## The archive
|
|
8
|
+
|
|
9
|
+
| Rule | Limit | What happens |
|
|
10
|
+
| --- | --- | --- |
|
|
11
|
+
| Entry point | `index.html` at the root of the build output | Refused |
|
|
12
|
+
| Compressed size | 4096 MiB | Refused |
|
|
13
|
+
| Uncompressed size | 5120 MiB | Refused |
|
|
14
|
+
| File count | 25,000 | Refused |
|
|
15
|
+
| Compression ratio | 200 : 1 | Refused, as a zip bomb guard |
|
|
16
|
+
| Paths | Case matches the file on disk; no `../`, no symlinks, no absolute paths | Refused |
|
|
17
|
+
| Native programs | Any file ending in `exe`, `dll`, `scr`, `msi`, `msix`, `appx`, `sys`, `cpl`, `bat`, `cmd`, `ps1`, `vbs`, `vbe`, `wsf`, `jse`, `hta`, `msp`, `jar`, `apk`, `aab`, `xapk`, `ipa`, `dmg`, `pkg`, `mpkg`, `deb`, `rpm`, `appimage`, `dylib`, `lnk`, `reg`, or one that starts like a Windows, Linux or macOS program | Refused |
|
|
18
|
+
| Excluded | `node_modules/`, `.git/`, `.env*`, source maps, OS junk | Stripped, with a `files_excluded` notice |
|
|
19
|
+
| `opengame.json`, `.opengame/`, `opengame-assets/` | Project files, not game files | Stripped silently |
|
|
20
|
+
|
|
21
|
+
`opengame.json` stays out of the bundle on purpose: the manifest describes the game to
|
|
22
|
+
the platform and is not one of the game's files.
|
|
23
|
+
|
|
24
|
+
## Games past the archive limits
|
|
25
|
+
|
|
26
|
+
A decompilation, mod or recompilation with gigabytes of game data can send its large
|
|
27
|
+
files outside the archive on the `large-game-v1` plan: at most
|
|
28
|
+
12 GiB in 32,768
|
|
29
|
+
files, and 1 GiB for one file. The archive keeps the
|
|
30
|
+
limits above. The plan is open to every active account, and `opengame deploy` chooses it by
|
|
31
|
+
itself for a build past the ordinary limits, the same as `--external-assets auto`.
|
|
32
|
+
|
|
33
|
+
Write `{"delivery": "large-game-v1", "assets": "auto"}` to a file and pass it as
|
|
34
|
+
`--external-assets <file>` to both `opengame check` and `opengame deploy`. With `"auto"` the
|
|
35
|
+
CLI sends every file of 1 MiB
|
|
36
|
+
or more separately, then the largest of the rest until the archive fits. HTML, JavaScript,
|
|
37
|
+
CSS, XML, SVG, wasm, web manifests, SWF and PDF stay in the archive, and so does
|
|
38
|
+
`opengame.json`. A Kaigen build uses `kaigen-assets-v1` instead.
|
|
39
|
+
|
|
40
|
+
## Credentials
|
|
41
|
+
|
|
42
|
+
OpenGame no longer scans a build for keys. Every file in it can be read by every player,
|
|
43
|
+
comments included, so a key in the bundle is a key anybody has. Keep keys on the creator's
|
|
44
|
+
server. If a key has already shipped in a build, rotate it; removing it from the next
|
|
45
|
+
build does not take it back.
|
|
46
|
+
|
|
47
|
+
Identity, leaderboards and achievements come from the page through the SDK (see
|
|
48
|
+
`opengame-sdk`), so those need no key. To call an API that does need one, such as an AI
|
|
49
|
+
model, put the key on the creator's own server and have the game call that server.
|
|
50
|
+
|
|
51
|
+
## Where a game may connect
|
|
52
|
+
|
|
53
|
+
Besides the game's own origin, `https://api.opengame.gg`,
|
|
54
|
+
`wss://rtc.opengame.gg` and `https://rtc.opengame.gg`, a new release
|
|
55
|
+
may reach any `https:` or `wss:` host: an AI model, a third-party API, the creator's own
|
|
56
|
+
server, and scripts, stylesheets, fonts and media from a CDN. Releases made
|
|
57
|
+
before 26 Oct 2026 keep a contract that allows OpenGame's hosts only.
|
|
58
|
+
|
|
59
|
+
Before the game calls out:
|
|
60
|
+
|
|
61
|
+
- Each call goes from the player's browser, so that host gets the player's IP address.
|
|
62
|
+
- The review sandbox does not reach the internet. The game must still draw its first
|
|
63
|
+
frame when its server is out of reach.
|
|
64
|
+
- The game page is `https:`, so the browser blocks `http://` and `ws://` requests.
|
|
65
|
+
- A build that uses threads is cross-origin isolated. There a script or image from
|
|
66
|
+
another host loads only if that host sends CORS or `Cross-Origin-Resource-Policy`
|
|
67
|
+
headers.
|
|
68
|
+
- A library from a CDN can be slow, go down or change after review. Bundle it when you
|
|
69
|
+
can.
|
|
70
|
+
|
|
71
|
+
## What a game may not do
|
|
72
|
+
|
|
73
|
+
Refused whatever host the game uses. `opengame check` and the review sandbox look for
|
|
74
|
+
the common services and code shapes, and automatic review plays every game.
|
|
75
|
+
|
|
76
|
+
- **Payments.** Games on OpenGame are free to play. A game may not take money, tips, donations or card details, or send players to a page that does.
|
|
77
|
+
- **Crypto.** Games on OpenGame may not use crypto wallets, tokens, NFTs or blockchains, and may not mine.
|
|
78
|
+
- **Accounts.** Players start playing without making an account, signing in, or giving an email address. OpenGame gives every game a player through the SDK, so a game never needs its own sign-in. An anonymous sign-in to the
|
|
79
|
+
game's own backend, such as Firebase anonymous auth, is fine, because the player is
|
|
80
|
+
never asked for anything.
|
|
81
|
+
- **Ads.** Games on OpenGame may not show ads. A portal SDK such as Poki's or CrazyGames' serves ads, so remove it.
|
|
82
|
+
- **Tracking.** Games on OpenGame may not carry ad pixels or session recording. Use the SDK's events for analytics.
|
|
83
|
+
|
|
84
|
+
A game also may not put another site in an iframe, post a form, or open a popup. Links
|
|
85
|
+
out go through `og.openLink`. OpenGame does not open links to the payment, crypto and sign-in services on its list, judged by the address the game passes, not by where it redirects. Do not hide a service from the checks by renaming or encoding it; review
|
|
86
|
+
plays the game against the rule, not against the list.
|
|
87
|
+
|
|
88
|
+
## What the checks measure
|
|
89
|
+
|
|
90
|
+
| Check | What it asks | Blocks |
|
|
91
|
+
| --- | --- | --- |
|
|
92
|
+
| `archive` | Archive is safe to open | yes |
|
|
93
|
+
| `entry` | index.html at root | yes |
|
|
94
|
+
| `boot` | Boots and renders | yes |
|
|
95
|
+
| `net` | No disallowed origins | yes |
|
|
96
|
+
| `size` | Initial download | no, a warning |
|
|
97
|
+
| `tti` | Time to playable | no, a warning |
|
|
98
|
+
| `mem` | Peak memory | no, a warning |
|
|
99
|
+
| `fps` | Frame rate | no, a warning |
|
|
100
|
+
| `desktop` | Works at every size | no, a warning |
|
|
101
|
+
|
|
102
|
+
No person reviews a game. Once these pass, review plays it and decides by itself: the
|
|
103
|
+
game goes on to be published, or back to the creator with the reason. It goes back when the
|
|
104
|
+
build fails packaging, when its review cost more than any game should need (make it smaller
|
|
105
|
+
or simpler), or when a confident verdict reads it as not a real game, as made for a phone
|
|
106
|
+
held upright, or as not running on a supported web runtime. The creator then
|
|
107
|
+
confirms the details and certifies the rights on the deploy's page.
|
|
108
|
+
|
|
109
|
+
Thresholds that warn rather than refuse: an initial download over
|
|
110
|
+
50 MiB before the first playable frame, time to
|
|
111
|
+
playable over 10 seconds, a median frame rate under
|
|
112
|
+
45 on the test machine. A first frame later than
|
|
113
|
+
30 seconds fails the boot check. The desktop check loads the
|
|
114
|
+
game at 1920 x 1080 (primary), 1366 x 768, 2560 x 1440, 3440 x 1440, 1024 x 640 and expects it to respond to resize.
|
|
115
|
+
|
|
116
|
+
## Manifest limits
|
|
117
|
+
|
|
118
|
+
`opengame.json` itself is at most 64 KiB, with at most
|
|
119
|
+
25 leaderboards. See [manifest.md](manifest.md).
|
|
@@ -0,0 +1,154 @@
|
|
|
1
|
+
> Carried from `opengame-depth` 1.1.0. Read it when: Give a browser game depth, not a single verb. Covers a natural win proved by seeded skill tiers and real runs, simulated players calibrated to people, pacing in the player's own unit, an economy tuned by prices, boss health from real damage, a first goal at spawn, a spawn controller, rounds that never stall, readable bosses, honest cheats, odds and systems that interact. Use when the person says the game is boring, too hard, too easy, rounds drag, I died rich, or it feels like a tech demo.
|
|
2
|
+
|
|
3
|
+
|
|
4
|
+
# Depth
|
|
5
|
+
|
|
6
|
+
A game is deep when its systems create decisions together: what you carry changes how
|
|
7
|
+
you fight, the ground changes your route, what you prepare changes the next encounter.
|
|
8
|
+
A decorative counter, a menu for an unfinished system or a bigger map is not depth. The
|
|
9
|
+
fastest way to look shallow is a minigame: one verb, no consequence, nothing to learn.
|
|
10
|
+
|
|
11
|
+
Balance is where agents fool themselves most easily, because a simulated player is cheap
|
|
12
|
+
and a person is not. In LC every pacing number chosen on simulated players was later
|
|
13
|
+
corrected by the owner's own hands, so the rules below calibrate the simulation to a
|
|
14
|
+
person first and count only unflagged real runs as evidence.
|
|
15
|
+
|
|
16
|
+
Rules carry five tags; `opengame-quality-bar` explains them and the game codes. OC's run is
|
|
17
|
+
a wave shooter with rounds of zombies, three generators to defend and then a boss. LC's is
|
|
18
|
+
a survival shooter whose levels rise on a clock, with points spent on weapons, doors and
|
|
19
|
+
power. OH's songs are its levels.
|
|
20
|
+
|
|
21
|
+
## Rules
|
|
22
|
+
|
|
23
|
+
### Prove a natural win exists
|
|
24
|
+
- **Invariant:** Before any tuning for feel, unstaged runs show that a player can reach and finish every stage of the run with the gear the game gives them: first by seeded simulated players at several skill tiers, then by real-input runs with no flags or cheats.
|
|
25
|
+
- **Technique:** Write the target outcome for a strong, an average and a new player. Build a headless simulation from the game's real rules, director, weapons and map, with seeded novice, average and good players over many seeds, and log where each run ends and why. Compare enemy health, player damage and boss health against what a full loadout can deal. Change one value at a time. Then play several real-input runs with no flags, logging time, cause of death, ammunition and money held. Flagged or cheat runs never count as balance evidence.
|
|
26
|
+
- **Reference configuration:** OC's first audit lost 7 of 7 natural bot runs: round 1 zombies had round 10 health, and each boss lock-core had 35,000 HP, more than a full loadout could deal. OC's targets: the boss wakes by round 8 to 10 for a great player, 10 to 12 for a decent one and 12 to 15 for a beginner. LC's targets: a novice alive at 3 minutes in 80% of runs, an average player restoring power in 60%, a good one winning in 30% within 25 to 40 minutes. Its simulation (hit chance near, at 30 m and on the head of 0.55/0.20/0.10, 0.74/0.36/0.27 and 0.86/0.50/0.42 by tier; 1 to 5 s a run) reached 32, 21 and 14 of 32, yet real runs died dry at 1:24 to 5:54 holding 4,000 points, because the simulated player bought and reloaded rationally.
|
|
27
|
+
- **Applies when:** Every game with a win condition, runs, waves or a boss.
|
|
28
|
+
- **Verify:** Before and after tables per tier for every change, plus three real-input runs that reach each stage within its band; the report lists the round and cause of every loss.
|
|
29
|
+
|
|
30
|
+
### Never tune difficulty on players that do not move like people
|
|
31
|
+
- **Invariant:** No difficulty, pacing or economy number is chosen from simulated players until they move, aim and fire at human rates, and no pacing device softens the danger to suit a simulated player.
|
|
32
|
+
- **Technique:** Measure three biases against real-input runs: how fast the simulated player moves while aiming, how many aimed shots it lands a minute, and the enemy's damage clock as the browser runs it. Replay a recorded real run headless on its own seed, and require the simulation to match it within a fifth. Run a passive player who never moves: if they are never downed within a few minutes, something is hiding the danger. Count difficulty in the player's unit (blows to down), change the blow rather than a health scale, and ship numbers chosen on the simulation behind a take-back, naming the population they were tuned on.
|
|
33
|
+
- **Reference configuration:** LC's simulated players backed away at 2.3 m/s where a person aiming backs at 1.33 ("slower than one of the dead at a walk"), killed 25 to 30 a minute where a real hand managed 13, and saw blows spaced 2.2 s where the browser spaced them 2.62. Because scripted players kept dying, LC added a shared 5 s gap between blows and made zombies take turns; a scripted novice then stood at 45:00 in 11 of 12 runs, and the owner asked "the zombeis take so long ot kill u?", then "also it should be 3 hits (without perks) to die not just 2". Settled: 34 of 100 a blow, three to down, each enemy on its own clock of about 1.1 s. Every tide figure chosen on the simulation was later corrected by the owner's play.
|
|
34
|
+
- **Applies when:** Every game balanced with simulated players or bots.
|
|
35
|
+
- **Verify:** The record test (the simulation within 20% of a real run from minute four), and the passive player downed within three minutes.
|
|
36
|
+
|
|
37
|
+
### Pace in the player's own unit
|
|
38
|
+
- **Invariant:** Pacing targets are written in what the player experiences (enemies met a minute, the longest lull, notes a second, blows to down), and a new player meets the game's threat within seconds and keeps meeting it, surviving the opening because early threats are weak, not because they are absent.
|
|
39
|
+
- **Technique:** Measure enemies met a minute (first within reach and in view) and the longest lull in recorded runs. Make early enemies die fast rather than come rarely; bring them in ahead and out of sight, and recycle stragglers. Frighten first by number, flank, voice and dark, and bring faster enemies in only after the player knows the basics. In a rhythm or timing game, set each difficulty by density, spacing and the busiest second, calibrated to the genre's measured norms, and move a piece that plays under its tier down rather than padding it. Nothing should be boring, too easy or too slow.
|
|
40
|
+
- **Reference configuration:** LC: "im 2 mins into game and only saw 2 zombies?... way too slow paced game play" (owner), after the director "made the opening survivable by starving it of zombies"; then "im 5 mins in and no zombeis are runnin gyet?". Targets: first contact at 10 to 15 s, at least 8 met in minute one, 14 more in minute two and 20 more in minute three, no gap over 8 s; health 80 and 100 at levels 1 and 2 so the starting weapon kills with one head shot; no surge for 75 to 90 s; runners from minute 2 and a first sprinter alone at 3:30; stragglers 45 m behind for 4 s replaced, the longest quiet down from 27 to 6 s median. OH calibrated its charts to aggregates of a published genre's charts (no audio fetched, nothing copied): median 1.61, 2.44, 3.40 and 3.98 notes a second from Easy to Expert, busiest second 4, 5, 8 and 10. "no song should be boring too play or too easy or too slow" (owner); OH set a tempo floor of 118 bpm.
|
|
41
|
+
- **Applies when:** Every game with a difficulty curve, waves or a tempo.
|
|
42
|
+
- **Verify:** Count met-per-minute (or notes a second) and the longest lull in recorded real runs, not only in simulation.
|
|
43
|
+
|
|
44
|
+
### Tune the economy through prices
|
|
45
|
+
- **Invariant:** The economy is tuned through prices, the first purchase fits the first purse, a better item is never the poorer buy, and a run cannot die rich.
|
|
46
|
+
- **Technique:** Price the first things on the route for the starting money and leave the starting money alone, since it is spent at once. Price ammunition by the round so a stronger weapon is never the worse deal. Write the economy in minutes of earnings: what comes in a minute, and what one of everything on the objective's way costs. Keep one ordered line telling the player what their money now covers. Never put a paid way out at a dead end. Log money held at every death.
|
|
47
|
+
- **Reference configuration:** LC: "starting points are the wrong lever (they are spent at the rack at once)". A 400-point pistol beside a 500-point start was bought within 5 s in 15 of 16 runs and cut power restored from 12 to 5 of 16; a 200-point rifle halved novice survival; the first door went from 750 to 500 to 0. Rounds cost 2.25 each, never over 750 unupgraded. About 1,000 points come in a minute, and one of everything on the objective's way costs 14,850, "fifteen minutes of earnings". One 42-minute run died with 61,030 points unspent, and another walked 219 m back for rounds while holding 3,240.
|
|
48
|
+
- **Applies when:** Every game with a currency, a shop or upgrades.
|
|
49
|
+
- **Verify:** Per run, money held at death and the time to the first purchase: a novice run buys within its first minute, and no tier dies holding more than one purchase's worth.
|
|
50
|
+
|
|
51
|
+
### Boss health comes from the damage a player can deal
|
|
52
|
+
- **Invariant:** The boss's health and each vulnerable window are sized from the damage the expected loadout deals in that window, and one document holds the number.
|
|
53
|
+
- **Technique:** Compute damage per second for the loadout a player has at that stage, multiply by the length of each vulnerable window and the number of windows the fight should take, and set health from that. Keep the value in one spec file that code reads.
|
|
54
|
+
- **Reference configuration:** OC's spec said 400,000 HP while the code held 60,000, and the spec had 4 phases against the code's 3. The rebalance moved to the reference game's solo formula with the titan at 120,000.
|
|
55
|
+
- **Applies when:** Games with bosses, shields or damage gates.
|
|
56
|
+
- **Verify:** A bot with a middle loadout breaks one weak point inside one window, and a full fight lands inside the target length.
|
|
57
|
+
|
|
58
|
+
### The first goal is reachable at spawn
|
|
59
|
+
- **Invariant:** A new player can afford and see the first goal from where they start, and the objective panel, banners, voice and tips all state the same goal in the same words.
|
|
60
|
+
- **Technique:** Price the first purchase or gate at or below the starting money. Write each objective once, in one table, and drive the panel, banner, voice line and loading tip from it. Prompts name the action and the cost.
|
|
61
|
+
- **Reference configuration:** OC started the player with 500 points against a 750 gate, a design bug; the fix was a 500 gate and a "First: Quick Revive (500)" tip. OC once shipped three boss instructions at once, and its HUD still said "lock-cores 0/4" after the mechanic changed. Its prompt form: "Hold F to open the East Gate [750]". LC's pointer names the next place by walking distance ("YARD GATE 40 M"; `opengame-maps`).
|
|
62
|
+
- **Applies when:** Every game with an economy or an objective chain.
|
|
63
|
+
- **Verify:** A stranger reaches the first goal without help, and a search of the strings finds each objective worded once.
|
|
64
|
+
|
|
65
|
+
### A spawn controller owns wave size, the cap and placement
|
|
66
|
+
- **Invariant:** One controller sets how many enemies each wave has, how many may be alive at once and where they appear, and early waves are easy and close to the player without ever leaving the opening empty.
|
|
67
|
+
- **Technique:** A table of wave sizes and health per round or level, a hard cap on live enemies, spawns spread across several approaches near the player, and no spawns during breaks. Every other system asks the controller for spawns instead of creating enemies itself. Test that every standpoint has spawns on several sides (`opengame-maps`).
|
|
68
|
+
- **Reference configuration:** OC used the reference game's solo counts (6, 8, 13, 18, 24) and at most 24 alive (R110). Before the controller, early rounds flooded with spawns. LC's tide: a level every 100 s, a cap of 9 plus 0.6 a level, the first figure up at 2.5 s and one every 4 s after, the first surge at 75 s or the first generator, an ebb at two thirds of the rate, and at most 3 within 10 m of a hemmed-in player. Spawn accounting and the remaining-enemies counter are in `opengame-enemies`.
|
|
69
|
+
- **Applies when:** Wave, horde and arena games.
|
|
70
|
+
- **Verify:** Log spawns per second and live count across the first five rounds or levels: each wave matches the table and the live count stays at or under the cap.
|
|
71
|
+
|
|
72
|
+
### Rounds never stall
|
|
73
|
+
- **Invariant:** Every round ends a short time after the player kills what they can reach, and the last enemies are easy to find.
|
|
74
|
+
- **Technique:** Keep early breaks short, recover stragglers that stop making progress, respawn an enemy that has been out of sight and stuck for too long (only where no live or replay camera can show it; `opengame-enemies`), and point at the last few enemies with a marker that shows above or below. Run full games with real input to find the stalls.
|
|
75
|
+
- **Reference configuration:** OC's breaks are 5 s in rounds 1 to 3 and 10 to 12 s after; stragglers are recovered after 12 s; markers appear once fewer than 5 remain (the last 1 to 4 at the radar edge). One OC round took 313 s. The owner asked for faster early rounds about 9 times. Stuck-enemy recovery steps are in `opengame-enemies`.
|
|
76
|
+
- **Applies when:** Wave and round-based games, and any objective that waits for "kill all".
|
|
77
|
+
- **Verify:** Over 20 automated rounds, log time from the last reachable kill to the round end: none exceeds the straggler limit.
|
|
78
|
+
|
|
79
|
+
### Defence objectives are short and bounded
|
|
80
|
+
- **Invariant:** A defend-this objective has a fixed length, a limit on attackers and a readable health for the thing defended, each one has its own sound, effects and voice, and work the player puts into it is never lost.
|
|
81
|
+
- **Technique:** Set the duration, the number of attackers allowed at once, the spacing between their spawns and the damage each hit does to the objective. Show the objective's health while it is attacked. Give each objective its own music, effect and start, middle and end lines. Keep progress through a shot, a blow, a step away or a pause. Run timers that several players share (revives, bleed-outs, lifts) on the wall clock, not on each page's game time.
|
|
82
|
+
- **Reference configuration:** OC's sleeping titan wakes after three generators are defended (R89, which replaced three seals). The owner's game "crashed again while defending a generator", so each objective also needs its own soak test. LC's crank keeps its turns through a shot, a blow, a step off or a minute away; one-handed work ignores shots, and two-handed work pauses for 0.5 s. On game time, one of LC's 12 s lifts took 3 s on slow pages.
|
|
83
|
+
- **Applies when:** Escort, hold, capture and defend objectives.
|
|
84
|
+
- **Verify:** Play each objective with no damage dealt: it fails at the expected time. Play it well: it succeeds within its duration, and its health bar matches the logged hits.
|
|
85
|
+
|
|
86
|
+
### The player always knows how to hurt the boss
|
|
87
|
+
- **Invariant:** At every moment of a boss fight the player can tell the one current goal, where to shoot, and whether the shot did anything.
|
|
88
|
+
- **Technique:** One goal per phase, worded the same in the HUD, banner and voice. Weak points that are large enough on screen at any range, saturated and pulsing, in a colour that means "shoot here" everywhere in the game and does not also mean danger. Damage numbers on a hit and an "immune" cue on a blocked one. A visible break when a weak point falls. The boss's own animation and telegraphs are in `opengame-enemies`.
|
|
89
|
+
- **Reference configuration:** OC's owner: "its completely unclear how to take down the titan or where u hvae to aim for / shoot at", raised 4 or more times; "i couldnt tell fi ti does anything". OC's fixes: weak points at 28 to 32 px or more at any range (1.5 to 2% of frame width), pulsing; crack beats at 66% and 33% health; a 2.5 s stagger on a break; orange means immune, cyan or violet means shoot here. A test bot hit weak points for only 8 of 489 s. One redesign left the boss asleep forever in normal runs.
|
|
90
|
+
- **Applies when:** Any boss or multi-stage enemy.
|
|
91
|
+
- **Verify:** A stranger plays the fight with no briefing and says, at three random pauses, what the goal is and where to shoot. Capture the weak points at the nearest and farthest fighting range.
|
|
92
|
+
|
|
93
|
+
### Stage any moment of a run, and keep cheats honest
|
|
94
|
+
- **Invariant:** Developers, test agents and the owner can jump to any round, phase or objective with any loadout, every run that used a cheat is marked as one from its first frame, and no test switch reaches production.
|
|
95
|
+
- **Technique:** Dev switches for god mode, no enemies, extra money, any weapon, every gate open, each objective complete and a jump to any round or straight to the boss. Use them to reach and test late content; judge feel and difficulty only on unstaged runs. When cheats are a player feature, read them once at a new run, mark the run cheated and keep it off records, stamp the cheat state into every capture's name, and test the path with every cheat the owner keeps saved. Tool-only invulnerability is a script call, never a URL flag. Strip the dev switches from the production build or lock them behind a key the server checks.
|
|
96
|
+
- **Reference configuration:** OC's set: god mode, ghost town, +50,000 points and a jump to any round, after the owner told agents to "give urself god mode / infinite health". OC's production build stores the dev key only as a hash. Dev flags still leaked fake points into captures. LC's owner played with every cheat saved; six saved perk grants put the gun aside for 3.5 s at spawn, reported four times, while tests ran with two. "None of my 34 earlier spawns was begun by a real press."
|
|
97
|
+
- **Applies when:** Every game longer than a few minutes, and every game with a player-facing cheats menu.
|
|
98
|
+
- **Verify:** Reach the boss from a cold start in under a minute in a dev build; in the production build every dev switch does nothing, and a run with every cheat saved starts with the weapon in hand.
|
|
99
|
+
|
|
100
|
+
### Random rewards have tuned odds and a pity timer
|
|
101
|
+
- **Invariant:** Random rewards follow odds set against the genre reference, a long dry streak ends, and every path that can grant a rare item goes through the same odds.
|
|
102
|
+
- **Technique:** Write the odds per rarity, add a pity counter, show rarity with spectacle (colour, beam, sound), and list every code path that writes to an inventory slot so a rare item cannot arrive by another route. Audit each weapon's time to kill at several stages of the run.
|
|
103
|
+
- **Reference configuration:** OC's wonder weapon came at 1 in 56, then about 1 in 102, against 1 in 20 to 25 in the reference game; pity after 16 to 20 pulls. Wonder weapons are crate-only, which meant auditing 11 slot-write paths. Time to kill is audited at rounds 1, 10, 20 and 30.
|
|
104
|
+
- **Applies when:** Games with loot boxes, drops, crates or random rewards.
|
|
105
|
+
- **Verify:** Simulate 10,000 pulls and compare the rates with the table; trace each slot-write path to the odds function.
|
|
106
|
+
|
|
107
|
+
### Systems are defined before code
|
|
108
|
+
- **Invariant:** Each system in the game exists because it changes a decision the player makes, and that change is written down before the system is built.
|
|
109
|
+
- **Technique:** For each system, one line each: the decision it creates, what it interacts with, and how the player learns it. Cut any system with no answer. Build the interactions, not only the systems: a power-up changes what enemies perceive, not only how the player looks, and a strong tactic carries its own counter.
|
|
110
|
+
- **Reference configuration:** ST's craft defaults: different weapons change tactics, terrain changes routes, preparation changes the next encounter, and a decorative counter is not evidence of depth. OS's active camouflage had to change what bots see: with it on, bots fired 0 rounds over 133 hidden sightlines. OS's scope glint shows only after 250 ms scoped, within plus or minus 20 degrees of the victim and beyond 25 m, so camping carries its own counter.
|
|
111
|
+
- **Applies when:** Every game with more than one mechanic.
|
|
112
|
+
- **Verify:** Play two runs with different choices; the runs play differently in a way you can describe.
|
|
113
|
+
|
|
114
|
+
### The whole archetype, not a minigame
|
|
115
|
+
- **Invariant:** The game delivers the archetype it belongs to (its loop, progression, failure and reason to return), not only the first ten seconds of it.
|
|
116
|
+
- **Technique:** Name the genre's archetype and list what a player of it expects from a full session. Build the loop end to end (start, escalate, fail or win, retry with something learned) before widening any one part.
|
|
117
|
+
- **Reference configuration:** Our originals' rule after a laser-and-prism board with one verb was filed as the thing not to make again: every game is a deep game, with systems that interact, a run that teaches, and a reason to come back tomorrow.
|
|
118
|
+
- **Applies when:** Every game, at every scope. A small game can be deep; a big one can be a minigame.
|
|
119
|
+
- **Verify:** A person who did not build it plays three sessions and can say what they would do differently next time.
|
|
120
|
+
|
|
121
|
+
### One dense hero location first
|
|
122
|
+
- **Invariant:** One place in the game is finished to the bar before more places are added.
|
|
123
|
+
- **Technique:** Pick the location the first minute happens in and finish it: layout that creates routes and choices, a focal landmark, foreground, midground and distance, grounded props, the overhead layer, light and sound. Copy its standards outward, not its props. Its spec and parity list are in `opengame-maps`.
|
|
124
|
+
- **Reference configuration:** MC's Rust map: about 2,900 primitives, 423 decals in one draw, 109 contact-shadow quads and 1,500 dust motes in 44 by 44 m. SR's island: 2,609 props, 6,512 grass clumps and 913 flowers. OS spread its effort over 17 maps; new ones arrived scoring 1.4 to 1.8 out of 10, the owner rated them "1/10 on parity and 1/10 on aaa level visuals", and even the best was "probs a 5/10".
|
|
125
|
+
- **Applies when:** Every game with a world to move through.
|
|
126
|
+
- **Verify:** Captures of the hero location from the player's camera pass the cheap-tells review in `opengame-quality-bar`.
|
|
127
|
+
|
|
128
|
+
### Dressing is placed by rules
|
|
129
|
+
- **Invariant:** Set dressing looks authored: it sits where such things would be, never blocks paths or interactions, and comes out the same every session.
|
|
130
|
+
- **Technique:** Scatter from a seeded generator and reject candidates by surface, slope, footprint flatness, clearance from paths, stairs, doors and interactables, and a noise mask. Place props against real walls, not in the open; dress the overhead layer with pipes, ducts, beams and cables; rotate things a few degrees off square; keep litter low enough never to block movement or become a perch. A dressing pass never moves the gameplay layer (`opengame-world-physics`).
|
|
131
|
+
- **Reference configuration:** DK tries 8 positions per prop, each clear of walkways and against a wall, with per-room counts (a factory: 8 crates, 7 drums, 4 rubble piles, 3 machines). The ST bar's scatter rules keep half a path's width plus 1.2 m clear of paths and 5 m clear of stairs, reject footprints less flat than 0.45 m, and vary scale 0.7 to 1.5 with tint. Litter stays under 0.3 m. OS places groups by job, each under 1.1 m, within a budget of about 3,000 props a map, and its record says "randomly scattering more barrels will not repair a featureless main structure".
|
|
132
|
+
- **Applies when:** Any game with dressed spaces.
|
|
133
|
+
- **Verify:** The scene audit passes (`opengame-scene-audit`), and the walk bot reaches every interaction point.
|
|
134
|
+
|
|
135
|
+
### Opponents telegraph
|
|
136
|
+
- **Invariant:** Every threat shows what it is about to do in time for the player to answer, the answer is a skill the player can improve, and every special attack can be beaten by something the player already knows how to do.
|
|
137
|
+
- **Technique:** Anticipation before every attack (pose, sound, light), a readable recovery after it, and attack patterns that combine the same few tells in new ways as the game escalates. Check each special attack against the player's own moves: a lunge's landing area is smaller than the distance a sidestep covers in its flight time.
|
|
138
|
+
- **Reference configuration:** ST's craft defaults tie anticipation, contact, recovery, sound and visual cues to every real action. OC's boss wind-ups run at least 900 ms, and 2,500 ms for attacks that down the player (`opengame-enemies`). LC's blows wind up for 0.42 s and recover for 0.55 s; its dive's landing radius was cut to 0.9 m because a strafe at 2.7 m/s covers 1.36 m in its half-second flight.
|
|
139
|
+
- **Applies when:** Games with opponents, hazards or bosses.
|
|
140
|
+
- **Verify:** Mute the game and play: every attack can still be read from the picture. Then play with the screen dimmed: the important ones can be read from sound.
|
|
141
|
+
|
|
142
|
+
### Mashing does not win
|
|
143
|
+
- **Invariant:** Pressing buttons at random loses to playing well, at every difficulty past the first.
|
|
144
|
+
- **Technique:** Commitment on actions (wind-up, recovery, resource cost), punishable whiffs, and defence that rewards timing. Test it directly with a random-input bot.
|
|
145
|
+
- **Reference configuration:** A rule from the plan for OpenGame's craft skills (ST). None of our games measured it, so there is no number to copy: the random-input bot is the measurement.
|
|
146
|
+
- **Applies when:** Action, fighting and arcade games.
|
|
147
|
+
- **Verify:** A bot that presses random inputs for a full match scores clearly worse than a person who plays with intent.
|
|
148
|
+
|
|
149
|
+
### Teach in the scene
|
|
150
|
+
- **Invariant:** The player learns each action at the moment they need it, from the game itself, and the hints match the real keys.
|
|
151
|
+
- **Technique:** A short hint in the world, shown when the action first becomes useful, generated from the same action table input uses. No wall of controls before play.
|
|
152
|
+
- **Reference configuration:** Our originals' best opening is one line beside a live match with both control legends on screen: the menu states the verb.
|
|
153
|
+
- **Applies when:** Every game.
|
|
154
|
+
- **Verify:** A stranger completes the first objective without opening a help screen.
|
|
@@ -0,0 +1,155 @@
|
|
|
1
|
+
> Carried from `opengame-enemies` 1.1.0. Read it when: Make enemies, hordes, bots, teammates and bosses in a 3D browser game move and fight as designed. Covers reach tests, jump links, stuck and idle recovery, pacing in enemies met per minute, gaits at their own cadence, hit reactions without root motion, attacks on each enemy's own clock, rigs checked on their own skeletons, limp deaths, bots that read as players and a boss that telegraphs. Use when enemies get stuck, idle, slide or feel harmless, bots look robotic, or the boss feels dead.
|
|
2
|
+
|
|
3
|
+
|
|
4
|
+
# Enemies, hordes, bots and bosses
|
|
5
|
+
|
|
6
|
+
An enemy that stops moving breaks a game faster than anything else it can do. A zombie
|
|
7
|
+
pressed against a railing, a teammate frozen in the air or a horde counter that says 1
|
|
8
|
+
while a hundred spawn reads as broken within seconds. Most of these have three causes.
|
|
9
|
+
The navigation was built for a different body than the one walking it, the team does not
|
|
10
|
+
measure whether enemies arrive, and recovery is a guess.
|
|
11
|
+
|
|
12
|
+
Rules carry five tags; `opengame-quality-bar` explains them and the game codes. OC is
|
|
13
|
+
OG Clash, a first-person wave shooter with a boss. Its owner's longest-running complaint
|
|
14
|
+
was stuck zombies and teammates: about 35 messages between 16 and 21 Oct ("NO ONE should
|
|
15
|
+
ever gut stuck"), open across 40 or more builds, and about 5 days to close. OS filled
|
|
16
|
+
every lobby with bots presented as people, and its stuck stat read 1.0 per bot-hour while
|
|
17
|
+
its owner watched bots stand in a spiral. LC's dead tore their meshes in every clip until
|
|
18
|
+
each figure got its own rig, and its first minute was survivable only because it had
|
|
19
|
+
almost no zombies in it.
|
|
20
|
+
|
|
21
|
+
Navigation settings that must match the body (step height, radius, slope) are in
|
|
22
|
+
`opengame-world-physics`. Wave sizes, the live cap, spawn placement, tuning on calibrated
|
|
23
|
+
test players and the boss goal are in `opengame-depth`; this skill measures what the
|
|
24
|
+
player meets and how each enemy moves and fights. Rig audits and joint limits are in `opengame-characters`. Three.js
|
|
25
|
+
libraries and calls for everything here are in [references/threejs.md](references/threejs.md),
|
|
26
|
+
and LC's pacing tables and OS's bot model are in
|
|
27
|
+
[references/pacing-and-bots.md](references/pacing-and-bots.md).
|
|
28
|
+
|
|
29
|
+
## Rules
|
|
30
|
+
|
|
31
|
+
### Measure reach, not motion
|
|
32
|
+
- **Invariant:** Every enemy type reaches the player from every place the player can stand, and the team has measured the reach rate in a test.
|
|
33
|
+
- **Technique:** Build a pursuit test. Place the player at a grid of spots that covers floors, roofs, ramps, player-built structures and water exits; spawn several enemies at the real spawn points; log for each one whether it arrives and how long it takes. Count an enemy as stalled when its distance to the player stops falling while it is still far away, so circling in place counts as a failure. Run it on every build that touches navigation, and run real rounds as well, because the test only covers the spots you give it.
|
|
34
|
+
- **Reference configuration:** OC's pursuit test used 34 spots and 4 zombies per spot; stalled meant under 0.25 m/s of progress for 3 s while more than 3 m away. Reach within 40 s rose from 55% to 84%, and stalls fell from 0.76 to 0.11 per enemy-minute (R157). Real rounds still had 30% of zombies not arriving within 30 s, and roofs at 14 and 17 m stayed 0 of 8.
|
|
35
|
+
- **Applies when:** Any game whose enemies or allies chase the player through 3D space.
|
|
36
|
+
- **Verify:** The pursuit report lists reach rate, median time and stalls per spot, and the worst spots are captured on video.
|
|
37
|
+
|
|
38
|
+
### Pace in enemies met per minute, and make early enemies weak, not few
|
|
39
|
+
- **Invariant:** A new player meets enemies within seconds and keeps meeting them wherever they stand, and survives the opening because early enemies die fast, not because they are absent.
|
|
40
|
+
- **Technique:** Measure "met per minute": an enemy counts as met when it is first close and in view. Give early enemies low health, so the starting weapon kills with a headshot. Bring arrivals in ahead of the player by walking distance, out of sight, from at least three sides, and replace stragglers left far behind. Keep a lull floor: when nobody has come near for a while, bring some up. Count from recorded real runs, not only simulation, minute by minute.
|
|
41
|
+
- **Reference configuration:** LC's director "made the opening survivable by starving it of zombies", and the owner: "also im 2 mins into game and only saw 2 zombies?... way too slow paced game play" and "zombies also always need to be spawning all around u wherever u go". Targets: first contact in 10 to 15 s; at least 8 met in minute one, 14 more in minute two and 20 more in minute three; no gap over 8 s. Health 80, then 100, at levels 1 and 2 (a head round does 132); the first figure up at 2.5 s; a cap of 9 plus 0.6 a level; arrivals 16 to 36 m off, flanks and ahead 3:1, the empty side weighted 4x; nobody within 25 m for 8 s brings two up 12 to 34 m off; a straggler 45 m behind for 4 s is replaced (the longest quiet went from 27 s to a 6 s median); standpoints with spawns on fewer than three sides fell from 9.7% to 0.8%. Minute one passed in real runs while minutes two and three failed, which only a per-minute count showed.
|
|
42
|
+
- **Applies when:** Wave, horde and arena games.
|
|
43
|
+
- **Verify:** Per minute of recorded real runs: enemies met within close range, the longest lull and the sides they came from; a spawn-coverage test from every standpoint in every door state.
|
|
44
|
+
|
|
45
|
+
### Links for every move the agent can make
|
|
46
|
+
- **Invariant:** Every jump, drop, climb and gap an enemy's body can cross is in the navigation as a link the planner can use, including on geometry the player builds during play, and every runtime solid is in the navigation too.
|
|
47
|
+
- **Technique:** Generate links from the agent's capability (jump height, jump distance, safe drop height) by scanning ledges and gaps in the collision geometry, then publish them into the navigation. Rebuild them when the player places, raises or destroys a structure. Each link stores its action (walk to takeoff, jump, land) so the agent plays the right motion. A body able to jump still needs the planner to route it to the takeoff point. Make the planner's climb equal the mover's step, audit for one-way sinks and loose link ends, and put gates, barriers and placed pieces into the navigation as obstacles.
|
|
48
|
+
- **Reference configuration:** OC's agents wrote their own gap-link publisher, ballistic jump planner and stale-takeoff checks over about 18 builds (R116 to R134). In one live test "the player reached the roof, but the NPC jump link was never created". Zombies were found stuck behind a railing in a player-built tower. Dynamic jump links landed in R119. OS's navigation allowed 0.9 m climbs against a 0.4 m step, and flagging gates as obstacles took stuck time from 165 to 4 s.
|
|
49
|
+
- **Applies when:** Games with vertical levels, gaps, ledges, gates or player-built geometry.
|
|
50
|
+
- **Verify:** Draw every link in a debug view. Build each player structure, stand on top, and run the pursuit test from there; list sinks and loose link ends per map.
|
|
51
|
+
|
|
52
|
+
### Stuck enemies recover in escalating steps, unseen by any camera
|
|
53
|
+
- **Invariant:** An enemy that stops making progress always recovers, by steps that start small; a relocation happens only where no camera, live or recorded, shows it, and a stuck body the player is watching is never teleported (it sinks, as a last resort).
|
|
54
|
+
- **Technique:** Watch progress toward the target, not movement. When it stalls, repath or climb first, then side-step, then relocate out of the player's sight, and as a last resort sink a body the player is watching. Recycle stranded enemies that have gained little ground over a long window, as long as they are out of view and not close to the player. Limit how often one enemy may repath. A relocation is unseen only if no player can see the spot and no killcam, replay or spectator view will show it later; in a game with replays, lean on the small steps and drop regroup teleports, because a replay shows the bot vanishing.
|
|
55
|
+
- **Reference configuration:** OC's steps: repath or climb at 1.75 s, side-step at 3.25 s, respawn unseen at 5 s, sink if watched at 8 s (R183). Stranded recycle: under 1.5 m of gain in 35 s, out of view. Repath floor 0.5 s. OS rerouted at 2.5 s and relocated unseen at 5 s, only when no human could see; its killcams made every bot watchable ("when i watch a killcam from a bot it should be as if its a real human playing on other side"), so out-of-sight regroup teleports were ruled out. LC's wire watchdog: under 0.5 m of progress in 2 s, go round, then to the nearest crossing, then back under; a figure stuck 3 s or 45 m behind stops counting toward the cap.
|
|
56
|
+
- **Applies when:** Every game with chasing AI. The relocation step applies only where no replay can show it.
|
|
57
|
+
- **Verify:** Trap enemies on purpose (behind a railing, in a corner, on a ledge) and log each recovery step firing at its time; in a game with replays, scrub every replay for a vanishing body.
|
|
58
|
+
|
|
59
|
+
### An enemy that does not want to move counts as stuck
|
|
60
|
+
- **Invariant:** No enemy or bot stands frozen, paces a small area or idles while it knows where the player is, on any map; every navigation region has an exit; and the player never sees a body vanish.
|
|
61
|
+
- **Technique:** Count pacing (inside a small radius, not fighting, not holding a chosen spot) and idling beside stuck, because a stuck stat that counts only agents trying to move misses the ones that gave up. Exempt chosen perches and holds, so a sniper still holds an angle. Hand each case to the recovery steps above. Check height off the ground with stuck, since a guard against one snag can leave bodies hovering. Test by forcing one agent's goal onto its own feet.
|
|
62
|
+
- **Reference configuration:** OS's stuck stat read 1.0 per bot-hour while the owner watched bots stand in a spiral, and two green sweeps missed two thirds of a lobby standing on spawn for up to 245 s ("bots often get stuck down here we cant have bots getting stuck anywhere"). Counting pacing took those spells from 303 to 0; the final bar, stuck under 3 s and pacing under 5 s on all 17 maps over 23 bot-hours, came with kills per bot-hour up from 109 to 149. A ledge guard turned one snag into a 35 s hover 0.64 m up, and the floater guard after it let eight bots hang 1.1 m up. LC's dead stopped for more than 3 s about 30 times a run while they knew where the player was, and its rule became that none of the dead ever stands idle while it knows where the player is.
|
|
63
|
+
- **Applies when:** Navmesh AI on authored maps: bots, hordes and companions.
|
|
64
|
+
- **Verify:** Force one bot's goal to its own feet: flagged within 5 s. A full-lobby run per map reports longest stuck, longest pacing, longest idle, height off the ground, sinks and loose link ends.
|
|
65
|
+
|
|
66
|
+
### No perch the enemies cannot reach
|
|
67
|
+
- **Invariant:** Every place the player can stand, enemies can reach or attack, unless the design marks it unreachable on purpose and moves the player off it.
|
|
68
|
+
- **Technique:** Find the islands in the navigation the player can reach and the enemies cannot. Either link them, spawn attackers at their foot, or make the spot slippery with a short hint so the player slides off. A slide must not damage or teleport the player. Bots in a shooter hunt a player who camps high instead of ignoring them.
|
|
69
|
+
- **Reference configuration:** OC's navigation had 129 islands, and glide-only roofs at 14 and 17 m were safe camping spots. Its fixes: a no-perch slide after about 2 s with a hint and no damage or teleport (R164), siege spawns at the foot when the player is 3 m or more up for 0.5 s, and a target of a hit within 8 s on any build. OS's tower camper drew "0 rival shots ... in 57 s" until bots hunted high campers, then was engaged in 7.5 to 19.3 s and killed in 26 to 50 s.
|
|
70
|
+
- **Applies when:** Games with climbable geometry, player building or roofs.
|
|
71
|
+
- **Verify:** Stand on each high spot for 15 s with god mode on: the player is attacked or slides off on every one.
|
|
72
|
+
|
|
73
|
+
### Navigation work fits the frame
|
|
74
|
+
- **Invariant:** Navigation rebuilds and path requests never hitch the game, however much geometry changes or however many agents ask for paths.
|
|
75
|
+
- **Technique:** Rebuild navigation tiles across several frames with a per-frame budget and keep tiles small enough that one tile fits it. Model doors, gates and barricades as area costs or obstacles so opening one needs no rebuild. Do not rebuild for transient effects such as boss attacks. Spread path requests across frames with a queue, share results between agents headed to the same place, and use a spatial grid for separation instead of checking every pair.
|
|
76
|
+
- **Reference configuration:** OC's 4-piece player build dirtied about 111 tiles, caused 39 to 43 ms spikes and left new builds without a path for about 7 s. Throttling from 64 to 16 tiles a frame could not fix it alone, since one tile took about 40 ms. Another single collider change dirtied 104 tiles and gave 7 to 14 frames of 60 to 100 ms, and OC stopped rebuilding for smash attacks. OC's gates became infinite-cost areas with no rebuild. Ally pathing went from 18 calls to 1 (R140). OS's bot thinking cost only 0.33 ms a frame; measure before blaming the AI.
|
|
77
|
+
- **Applies when:** Games with dynamic geometry or more than a handful of agents.
|
|
78
|
+
- **Verify:** Place and destroy structures and trigger every boss attack in a horde round while logging frame time and navigation time per frame: no frame passes the budget.
|
|
79
|
+
|
|
80
|
+
### A gait plays at its own cadence, steers along walls, and the player outruns the fastest enemy
|
|
81
|
+
- **Invariant:** No enemy's walk or run plays slow or fast to fit its speed, feet do not slide, no figure treads against a wall, every near figure is posed every frame, and the player's sprint beats the fastest enemy by a clear margin.
|
|
82
|
+
- **Technique:** Pick the clip by stride and play it within a narrow band around its capture rate. Change gait, or stand and reach, when the ground covered asks for it; never blend between gaits. Pose every frame within the near range and thin updates only far away. Steer toward a point a few cells ahead so headings turn smoothly; turn along a wall instead of into it, go round only where there is a step's room, brake behind a standing back, and hold waiting figures out of the player's sight rather than walking them in place. Start each loop at its own phase, and set the top enemy speed well under the player's sprint. Count jumps, spins and reversals per figure.
|
|
83
|
+
- **Reference configuration:** LC: a fix for zombies treading at walls let clips slow to 0.1x and made "slow mo" runners ("some of hte zombies running look like they are running in slow mo"); held to 0.9 to 1.15x, 133 figure-seconds a minute went to 0. Foot slide fell from 19.1 to 6.1 cm; frames with no new pose, 144 to 297 of 720, went to 0 ("zombies walking dont walk smoothly they like move very jaggedly"); heading change fell from 17 to 2.5 degrees a frame; "a lot of zombies like run / walk against the walls very badly" went from 402 to 52 to under 1 figure-second a minute of wall treading, after a "prowl" rule meant to keep waiters busy had walked them into walls at 134.5; jumps, spins and reversals from 63, 423 and 42 to 0, 2 and 0. Speeds, rules against played, in m/s: shamble 0.85/0.83, walk 1.5/1.47, run 3.4/3.41, sprint 5.3/5.18. The owner: "ur running speed needs to be fastest than the fastest zombie by a margin"; the player sprints 6.3 against a zombie cap of 4.8 ("5.6 against 5.4 is not a margin").
|
|
84
|
+
- **Applies when:** Every game with walking or running enemies.
|
|
85
|
+
- **Verify:** Figure-seconds outside the rate band, figure-seconds treading at walls and foot slide per frame, measured at uneven frame lengths, and a count of jumps, spins and reversals over 5 minutes.
|
|
86
|
+
|
|
87
|
+
### Hit reactions carry no root motion
|
|
88
|
+
- **Invariant:** A struck enemy reacts in place with its upper body and, if pushed, steps with its own feet; it never slides sideways and snaps back.
|
|
89
|
+
- **Technique:** Strip root motion from additive hit clips and apply them to the upper body only, from the waist to the hands. Make a stagger a step along the facing, using the figure's own gait played backwards, rate-limited. Turn only the shoulders for hits far off the facing, and drop the struck shoulder on frontal hits so the reaction reads from the player's camera. The flinch's timing is in `opengame-game-feel`.
|
|
90
|
+
- **Reference configuration:** LC's owner: "when u hit zombies or shoot them they move sideways and then slide/jerk back into other position which is still not right". Root motion inside the additive clips reached 84 cm; the hips' lateral travel per frame went from 70 to 5 cm. Staggers are 42 cm heavy, 24 for a leg hit and 12 to 32 light, at most one per 1.1 s; past 70 degrees off the facing only the shoulders turn. OC's titan slid 27 m on a hit-react clip with root motion (below).
|
|
91
|
+
- **Applies when:** Every game where enemies are shot or struck.
|
|
92
|
+
- **Verify:** Per-frame hip lateral travel through a burst of hits from the front, side and back.
|
|
93
|
+
|
|
94
|
+
### Each enemy attacks on its own clock, and danger is set in counted blows
|
|
95
|
+
- **Invariant:** Every enemy in reach attacks on its own readable clock, several can hit at once, damage is counted in blows to down, and no pacing device softens the danger to suit a scripted test player.
|
|
96
|
+
- **Technique:** Give each attack a wind-up long enough to read and each enemy its own timer, with no shared gap and no turn-taking; an enemy held back by the crowd strikes from where it stands. Tune the blow, not a health scale. Tune lethality only after the test player is calibrated to a person (`opengame-depth`).
|
|
97
|
+
- **Reference configuration:** LC's director had set a shared 5 s gap between blows and made zombies take turns, because scripted players kept dying; a scripted novice then stood at 45:00 in 11 of 12 runs, and the owner: "the zombeis take so long ot kill u? it shouldb e claibrated to cod when they hit u and multiple can hit u at once". It overcorrected to two blows, then "it should be 3 hits (without perks) to die not just 2": 34 of 100 a blow (five blows with armour, a dive 45), a 0.42 s wind-up, a 0.55 s recovery, about 1.1 s between one enemy's swings, regeneration after 4 s; blows a minute from three enemies went from 111 to 165, live 33 minutes after the note.
|
|
98
|
+
- **Applies when:** Melee enemies, hordes and wave survival.
|
|
99
|
+
- **Verify:** Count hurt events in the page (66, 32, down) and blows a minute among 1, 2, 3 and 5 enemies.
|
|
100
|
+
|
|
101
|
+
### Every figure is checked on its own rig, and the build cries out at a broken pose
|
|
102
|
+
- **Invariant:** No shipped enemy clip tears the mesh at any detail level, and no figure ever shows a bind pose, spread arms, a missing fall, a part flying off or an untextured body.
|
|
103
|
+
- **Technique:** Animate each figure on its own rig, not retargeted onto a shared one, and run the deformation audit in `opengame-characters` over every figure, clip and frame, leaving failing clips out. Add console errors in the build for a rest pose, arms held level, and a killed figure that does not start to fall. Film library motion from the side before trusting its name.
|
|
104
|
+
- **Reference configuration:** LC's owner: "the rigs of zombies cant be distorting/squishing as thy move" and "their heads cant just fly out either ... the way they move and then just go t pose when they die". On a shared skeleton 56 of 56 clips failed; on each figure's own rig 572 of 572 passed (torn means an edge over 3x or under 0.25x its rest length, and a clip fails above 1% of the surface). The build errors fire on a rest pose, both arms out at the sides for 0.2 s, or no fall within 0.25 s of a kill. Side-lens films showed library "falls" were stunt breakfalls that the audit passed, and long coats and capes failed on automatic rigs.
|
|
105
|
+
- **Applies when:** Generated, bought or auto-rigged enemies.
|
|
106
|
+
- **Verify:** The audit table and worst-frame sheets per figure, and side-lens films at a quarter speed.
|
|
107
|
+
|
|
108
|
+
### Deaths match the weapon, fall limp, and stay while seen
|
|
109
|
+
- **Invariant:** Kill reactions follow the weapon fantasy (energy weapons drop bodies where they stand, shotguns and explosives throw them), every death falls with weight and goes limp, nothing flies off, and no body vanishes in the player's view.
|
|
110
|
+
- **Technique:** Pick a directional death clip from the hit, then hand over to physics or a limp solve with an impulse set per weapon class. Keep bodies while the player can see them, and retire them out of view under the cap and deadlines in `opengame-world-physics`.
|
|
111
|
+
- **Reference configuration:** OC's energy kills rise under 0.15 m and travel under 0.6 m; a point-blank shotgun throws 5 to 6 m/s with a sideways part; a pistol 1.7 m/s; explosives 4 to 5 m/s out and 3.5 to 4.5 up; directional death clips of 0.16 to 0.42 s come first. The owner: "ray guns hsouldnt make zombies fly", after agents had logged a wonder weapon backflip as a win. LC's owner disliked how its dead "die and fall and disappear"; its deaths went limp by Verlet on 22 joints at 1/120 s, and bodies stay.
|
|
112
|
+
- **Applies when:** Shooters and action games with physics deaths.
|
|
113
|
+
- **Verify:** Kill a row of enemies with each weapon class and measure rise and travel per body against the table; film a kill and look back at the spot after a turn.
|
|
114
|
+
|
|
115
|
+
### Bots read as players, measured by a behaviour count and judged on film
|
|
116
|
+
- **Invariant:** Bots that stand in for people move with purpose, peek, use cover, strafe in committed legs, and aim, scope and miss like people; they never snap, spin, clump or stand in the open; they hunt a camping player; and they use the player's body, input path and senses only.
|
|
117
|
+
- **Technique:** Give bots the human input path (recoil, scope, bolt) and a motor model: reaction times with a floor, drawn from a skewed distribution; flicks that undershoot and correct; smooth drift instead of resampled error; tremor while scoped. Never buff their stats. Drive drawn facing with a damped spring capped against the aim. Log a behaviour count per match (creeping, one-frame snaps, peeks, time standing in the open, shots at campers), fix the worst three, and check each with a same-frame A/B split by slot rather than alternating time windows. A power-up changes what bots perceive, not only how the player looks. Judge the result on film.
|
|
118
|
+
- **Reference configuration:** OS: "not just walkign around like stiff robots". Early rivals were aimbots: 26 of 37 deaths were quickscopes. Reactions of 150 ms or more and scoped shots 0.22 to 0.28 s after full zoom; creeping fell from 16 to 17% to 7% by strafing only under 28 m; one-frame yaw snaps of 17 to 28 degrees went from 1.7% to 0.2% of frames with a 0.06 s spring capped at 0.6 rad; peeks rose from 1 to 34 a match, and open-fight stills fell from 192 to 3 to 7 s by reloading in cover. A windowed A/B read -13% CPU and shipped for three releases; a same-frame split showed +46% and 4.5x the stuck bots. Under active camo bots fired 0 rounds over 133 hidden sightlines. Bot powers were rate-capped ("at most once every 5 minutes for at most 30 seconds").
|
|
119
|
+
- **Applies when:** Bots standing in for human players, and any AI the player watches in a killcam or replay.
|
|
120
|
+
- **Verify:** The behaviour count before and after in one build, and a 10-minute match film judged against "push, flank, use cover, never stand still in the open, never spin, and never run into walls".
|
|
121
|
+
|
|
122
|
+
### The counter matches the screen
|
|
123
|
+
- **Invariant:** The enemies-remaining number equals the enemies alive plus those still queued to spawn, every drawn enemy can be hit, and every hittable enemy is drawn.
|
|
124
|
+
- **Technique:** Keep one ledger that every spawn, death, despawn and respawn goes through, and drive the HUD from it. Keep each enemy's hit volume on its drawn body during leaps, climbs and recovery steps. Count a respawn as the same enemy.
|
|
125
|
+
- **Reference configuration:** Before OC's spawn accounting (R109) the owner saw "it says 1 remaining and ij ust had like a hundred spawn" and "says like 3 remaining but there are so many". "Ghost" zombies stayed visible and could not be shot. OC caps live zombies at 24 (`opengame-depth`).
|
|
126
|
+
- **Applies when:** Every game with a remaining-enemies count or a round end that waits for kills.
|
|
127
|
+
- **Verify:** Log the ledger and a count of drawn enemies every second through 10 rounds: they agree, and frames where a drawn body is far from its hit volume number zero.
|
|
128
|
+
|
|
129
|
+
### Teammates are measured like players
|
|
130
|
+
- **Invariant:** AI teammates follow, fight, revive and keep up with the player, and their success is measured on the routes they walked, with teleports counted separately.
|
|
131
|
+
- **Technique:** Track rejoin rate, time stuck, time frozen in the air, far revives and shots on the boss. Log every regroup teleport and report navigation-only success on its own. Give teammates formation slots beside or behind the player, keep them out of the player's view cone, cap their damage so enemies stay a threat, and credit each kill to one squad member.
|
|
132
|
+
- **Reference configuration:** OC measured 14.7% of teammate-seconds frozen in the air and 7 boss shots out of 322, and found that regroup teleports had inflated its teammate metrics. Earlier allies killing at 180 DPS within 6 m made zombies harmless; they now rescue only within 2.6 m. Teammates do rare flips every 30 to 60 s.
|
|
133
|
+
- **Applies when:** Games with AI squadmates, companions or bots in the player's team.
|
|
134
|
+
- **Verify:** A 10-minute run reports each metric with teleports excluded, against the previous build.
|
|
135
|
+
|
|
136
|
+
### The boss and every special attack telegraph, and a skill beats them
|
|
137
|
+
- **Invariant:** Every boss or special attack is announced in time to answer it, its warning travels at the speed of the real damage, and a skill the player has can beat it.
|
|
138
|
+
- **Technique:** A wind-up long enough to react, longer for attacks that down the player. Mark danger areas by their edge, a band and a progress wipe instead of a filled area that floods the view. Move a shockwave's visual and its damage front together. A dodge prompt names the verb. Size a lunge's landing radius under the distance a sidestep covers in its flight. Judge each attack from the player's lens as well as from beside. Weak points and the boss's goal are in `opengame-depth`. No boss action may hitch: prebuild its effects, death and results screens.
|
|
139
|
+
- **Reference configuration:** OC's wind-ups are at least 900 ms, and 2,500 ms for downing attacks. Dodge windows are 2.2 to 2.8 s. The shockwave travels at 20 m/s, matching its damage. A filled 10 m orange circle turned the whole view orange, so OC draws the rim, a glyph band and a wipe. The titan's death frame fell from 509 to 117 ms (R184). LC's leap gathers for 0.62 s from 2.5 to 4.4 m away, flies 0.44 to 0.75 s, never comes before 1:35 or within 38 s of the last, and lands within 0.9 m, because a strafe at 2.7 m/s covers 1.36 m in its half-second flight; it looked right from beside and went under the bottom of the picture from the lens.
|
|
140
|
+
- **Applies when:** Any boss, large enemy or special attack.
|
|
141
|
+
- **Verify:** Play each attack at 0.25 times speed beside its damage log: the warning and the damage line up. Sidestep each lunge from the lens: it misses.
|
|
142
|
+
|
|
143
|
+
### The boss is alive and moves with weight
|
|
144
|
+
- **Invariant:** The boss breathes, shifts and reacts on every screen it appears on, its feet stay planted, and its clips never slide it across the floor.
|
|
145
|
+
- **Technique:** Layer idle life (breathing, weight shifts, a roar or gesture) over every state, sleeping included. Add hysteresis to walk and turn decisions. Strip root motion from library clips and drive movement from the game. Fit menu and cinematic cameras from its live joints.
|
|
146
|
+
- **Reference configuration:** OC's titan breathes every 3 to 5.6 s, shifts weight about every 9 s and roars every 27 s. A hit-react clip with root motion slid it 27 m. The owner called it "jagged" and asked that it "move and live and breath and act like a real fucking titan", 3 or more times.
|
|
147
|
+
- **Applies when:** Bosses and large hero enemies.
|
|
148
|
+
- **Verify:** Watch 60 s of the boss on the title, in play and asleep: it moves the whole time, and its foot positions stay fixed while planted.
|
|
149
|
+
|
|
150
|
+
### A horde reads as many individuals and keeps off the lens
|
|
151
|
+
- **Invariant:** A crowd of one enemy type looks like individuals, every type reads at fighting range, and no enemy fills the first-person view.
|
|
152
|
+
- **Technique:** Offset animation phase, playback rate, scale and heading per enemy, vary stature, and pick repeats of one figure out of view with their own tint and stains. Keep enemy flesh lighter than the floor. Stop enemies short of the camera and push them back when they crowd it, fade anything that comes very close to the lens, and hide eye glows up close. Update far animations less often, but pose every near figure every frame.
|
|
153
|
+
- **Reference configuration:** OC: phase offsets 0 to 1.6 s, rate within 15%, scale 0.92 to 1.08; each type readable at 15 m; 25 to 35 enemies in frame for a horde to read; full animation under 25 m, every second frame under 45 m. Enemies stop at 1.05 m and are pushed back to 0.6 m; anything within 0.65 m of the lens dithers to 30%; eye glows hide within 3 m; a 4 m keep-out ring surrounds machines. The owner said they looked "lifeless, like robots" before. LC varied stature from 1.64 to 1.90 m after every zombie had stood exactly 1.80 m, drew 32 zombies in 0.50 ms with 162 draws through instanced skinning, and gave its dead a jaw driven by the voice and an amber eye shine (green read as one more pickup).
|
|
154
|
+
- **Applies when:** Games with crowds of enemies and a first-person or close camera.
|
|
155
|
+
- **Verify:** Let 24 enemies surround a still player and capture the frame: no two neighbours share a pose, and no enemy covers more than the agreed share of the view.
|