@opengamehq/cli 0.9.7 → 0.9.9
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +37 -17
- package/CHANGELOG.md +18 -0
- package/README.md +7 -6
- package/dist/cli.mjs +144 -144
- package/dist/opengame-global.js +3 -3
- package/dist/preflight-worker.mjs +14 -14
- package/dist/runtime-builder.mjs +1 -1
- package/dist/skills/manifest.json +1406 -142
- package/dist/skills/opengame-accessibility/SKILL.md +48 -32
- package/dist/skills/opengame-all-in-one/SKILL.md +195 -0
- package/dist/skills/opengame-all-in-one/references/opengame-accessibility/README.md +102 -0
- package/dist/skills/opengame-all-in-one/references/opengame-api/README.md +107 -0
- package/dist/skills/opengame-all-in-one/references/opengame-assets/README.md +168 -0
- package/dist/skills/opengame-all-in-one/references/opengame-assets/references/pipeline.md +164 -0
- package/dist/skills/opengame-all-in-one/references/opengame-audio/README.md +238 -0
- package/dist/skills/opengame-all-in-one/references/opengame-audio/helpers/audio-chain.js +325 -0
- package/dist/skills/opengame-all-in-one/references/opengame-audio/references/mix-notes.md +125 -0
- package/dist/skills/opengame-all-in-one/references/opengame-audio/references/qa-without-ears.md +177 -0
- package/dist/skills/opengame-all-in-one/references/opengame-capture/README.md +128 -0
- package/dist/skills/opengame-all-in-one/references/opengame-capture/references/pipeline.md +114 -0
- package/dist/skills/opengame-all-in-one/references/opengame-capture/references/threejs.md +161 -0
- package/dist/skills/opengame-all-in-one/references/opengame-characters/README.md +180 -0
- package/dist/skills/opengame-all-in-one/references/opengame-characters/references/first-person-body.md +108 -0
- package/dist/skills/opengame-all-in-one/references/opengame-characters/references/integration.md +144 -0
- package/dist/skills/opengame-all-in-one/references/opengame-characters/references/player-og.md +160 -0
- package/dist/skills/opengame-all-in-one/references/opengame-cli/README.md +189 -0
- package/dist/skills/opengame-all-in-one/references/opengame-deploy/README.md +223 -0
- package/dist/skills/opengame-all-in-one/references/opengame-deploy/references/json-events.md +63 -0
- package/dist/skills/opengame-all-in-one/references/opengame-deploy/references/manifest.md +89 -0
- package/dist/skills/opengame-all-in-one/references/opengame-deploy/references/packaging.md +119 -0
- package/dist/skills/opengame-all-in-one/references/opengame-depth/README.md +154 -0
- package/dist/skills/opengame-all-in-one/references/opengame-enemies/README.md +155 -0
- package/dist/skills/opengame-all-in-one/references/opengame-enemies/references/pacing-and-bots.md +108 -0
- package/dist/skills/opengame-all-in-one/references/opengame-enemies/references/threejs.md +193 -0
- package/dist/skills/opengame-all-in-one/references/opengame-front-end/README.md +185 -0
- package/dist/skills/opengame-all-in-one/references/opengame-front-end/references/launch.md +50 -0
- package/dist/skills/opengame-all-in-one/references/opengame-front-end/references/menus.md +81 -0
- package/dist/skills/opengame-all-in-one/references/opengame-game-feel/README.md +181 -0
- package/dist/skills/opengame-all-in-one/references/opengame-game-feel/helpers/spring.js +146 -0
- package/dist/skills/opengame-all-in-one/references/opengame-game-feel/references/feel-numbers.md +142 -0
- package/dist/skills/opengame-all-in-one/references/opengame-game-feel/references/killcam.md +88 -0
- package/dist/skills/opengame-all-in-one/references/opengame-jam/README.md +114 -0
- package/dist/skills/opengame-all-in-one/references/opengame-lighting/README.md +141 -0
- package/dist/skills/opengame-all-in-one/references/opengame-lighting/helpers/light-pool.js +185 -0
- package/dist/skills/opengame-all-in-one/references/opengame-loading/README.md +135 -0
- package/dist/skills/opengame-all-in-one/references/opengame-loading/helpers/loading-count.mjs +115 -0
- package/dist/skills/opengame-all-in-one/references/opengame-loading/references/threejs.md +141 -0
- package/dist/skills/opengame-all-in-one/references/opengame-look/README.md +181 -0
- package/dist/skills/opengame-all-in-one/references/opengame-look/references/matching-a-reference.md +73 -0
- package/dist/skills/opengame-all-in-one/references/opengame-look/references/painterly.md +69 -0
- package/dist/skills/opengame-all-in-one/references/opengame-look/references/post-and-lens.md +73 -0
- package/dist/skills/opengame-all-in-one/references/opengame-maps/README.md +74 -0
- package/dist/skills/opengame-all-in-one/references/opengame-maps/references/map-spec.md +77 -0
- package/dist/skills/opengame-all-in-one/references/opengame-mobile/README.md +86 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/README.md +183 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/briefs.md +293 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/day-one-questions.md +46 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/edge-cases.md +27 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/filmable.md +244 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/finishing.md +126 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/measure.md +282 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-capture.md +151 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-gates.md +84 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-genres.md +198 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-grammar.md +320 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-ops.md +127 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/og-snipers-record.md +110 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/owner-eye.md +214 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/reference-study.md +293 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/song.md +64 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/README.md +193 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/briefs.md +293 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/day-one-questions.md +46 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/filmable.md +244 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/measure.md +282 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-capture.md +151 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-gates.md +84 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-genres.md +198 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-grammar.md +320 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-ops.md +127 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/og-snipers-record.md +110 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/owner-eye.md +214 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/reference-study.md +293 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/song.md +64 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/README.md +174 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/briefs.md +293 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/day-one-questions.md +46 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/filmable.md +244 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/finishing.md +126 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/measure.md +282 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-capture.md +151 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-gates.md +84 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-genres.md +198 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-grammar.md +320 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-ops.md +127 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/og-snipers-record.md +110 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/owner-eye.md +214 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/reference-study.md +293 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/song.md +64 -0
- package/dist/skills/opengame-all-in-one/references/opengame-multiplayer/README.md +139 -0
- package/dist/skills/opengame-all-in-one/references/opengame-multiplayer/references/bot-lobbies.md +71 -0
- package/dist/skills/opengame-all-in-one/references/opengame-multiplayer/references/netcode.md +165 -0
- package/dist/skills/opengame-all-in-one/references/opengame-performance/README.md +177 -0
- package/dist/skills/opengame-all-in-one/references/opengame-performance/helpers/landing-pacer.mjs +86 -0
- package/dist/skills/opengame-all-in-one/references/opengame-performance/references/measuring.md +123 -0
- package/dist/skills/opengame-all-in-one/references/opengame-performance/references/webgpu.md +86 -0
- package/dist/skills/opengame-all-in-one/references/opengame-production/README.md +192 -0
- package/dist/skills/opengame-all-in-one/references/opengame-production/references/team.md +107 -0
- package/dist/skills/opengame-all-in-one/references/opengame-production/references/templates.md +153 -0
- package/dist/skills/opengame-all-in-one/references/opengame-quality-bar/README.md +170 -0
- package/dist/skills/opengame-all-in-one/references/opengame-quality-bar/references/cheap-tells.md +43 -0
- package/dist/skills/opengame-all-in-one/references/opengame-quality-bar/references/judges.md +95 -0
- package/dist/skills/opengame-all-in-one/references/opengame-quality-bar/references/review-prompt.md +32 -0
- package/dist/skills/opengame-all-in-one/references/opengame-rhythm/README.md +134 -0
- package/dist/skills/opengame-all-in-one/references/opengame-rhythm/references/charting.md +109 -0
- package/dist/skills/opengame-all-in-one/references/opengame-rhythm/references/timing.md +92 -0
- package/dist/skills/opengame-all-in-one/references/opengame-router/README.md +54 -0
- package/dist/skills/opengame-all-in-one/references/opengame-router/references/process.md +38 -0
- package/dist/skills/opengame-all-in-one/references/opengame-scene-audit/README.md +136 -0
- package/dist/skills/opengame-all-in-one/references/opengame-scene-audit/helpers/scene-audit.js +677 -0
- package/dist/skills/opengame-all-in-one/references/opengame-sdk/README.md +283 -0
- package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/engines.md +93 -0
- package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/frame.md +107 -0
- package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/identity.md +111 -0
- package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/leaderboards.md +115 -0
- package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/radio.md +71 -0
- package/dist/skills/opengame-all-in-one/references/opengame-stability/README.md +112 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/README.md +160 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/archetypes.md +113 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/briefs.md +273 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/core.md +129 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/craft.md +299 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/edge-cases.md +27 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/filmable.md +244 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/finishing.md +126 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/gates.md +184 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/measure.md +282 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/music.md +148 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/og-clash-record.md +133 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/ops.md +154 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/owner-eye.md +214 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/review.md +141 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/title.md +92 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/README.md +172 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/archetypes.md +113 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/briefs.md +273 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/core.md +129 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/craft.md +299 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/edge-cases.md +27 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/filmable.md +244 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/finishing.md +126 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/gates.md +184 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/measure.md +282 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/music.md +148 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/og-clash-record.md +133 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/ops.md +154 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/owner-eye.md +214 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/reference-set.md +92 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/review.md +141 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/title.md +92 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/README.md +141 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/archetypes.md +113 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/briefs.md +273 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/core.md +129 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/craft.md +299 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/edge-cases.md +27 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/filmable.md +244 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/finishing.md +126 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/gates.md +184 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/measure.md +282 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/music.md +148 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/og-clash-record.md +133 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/ops.md +154 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/owner-eye.md +214 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/review.md +141 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/title.md +92 -0
- package/dist/skills/opengame-all-in-one/references/opengame-verification/README.md +197 -0
- package/dist/skills/opengame-all-in-one/references/opengame-verification/helpers/browser-evidence.mjs +74 -0
- package/dist/skills/opengame-all-in-one/references/opengame-weapons/README.md +179 -0
- package/dist/skills/opengame-all-in-one/references/opengame-weapons/references/handling-numbers.md +114 -0
- package/dist/skills/opengame-all-in-one/references/opengame-weapons/references/reloads-and-hands.md +96 -0
- package/dist/skills/opengame-all-in-one/references/opengame-weapons/references/sights-and-scopes.md +98 -0
- package/dist/skills/opengame-all-in-one/references/opengame-weapons/references/threejs.md +240 -0
- package/dist/skills/opengame-all-in-one/references/opengame-world-physics/README.md +141 -0
- package/dist/skills/opengame-all-in-one/references/opengame-world-physics/references/measured-failures.md +79 -0
- package/dist/skills/opengame-api/SKILL.md +32 -6
- package/dist/skills/opengame-assets/SKILL.md +79 -31
- package/dist/skills/opengame-assets/references/pipeline.md +67 -0
- package/dist/skills/opengame-audio/SKILL.md +129 -41
- package/dist/skills/opengame-audio/references/mix-notes.md +44 -1
- package/dist/skills/opengame-audio/references/qa-without-ears.md +177 -0
- package/dist/skills/opengame-capture/SKILL.md +44 -20
- package/dist/skills/opengame-capture/references/pipeline.md +33 -1
- package/dist/skills/opengame-capture/references/threejs.md +17 -1
- package/dist/skills/opengame-characters/SKILL.md +94 -39
- package/dist/skills/opengame-characters/references/first-person-body.md +108 -0
- package/dist/skills/opengame-characters/references/player-og.md +1 -1
- package/dist/skills/opengame-cli/SKILL.md +4 -4
- package/dist/skills/opengame-deploy/SKILL.md +35 -15
- package/dist/skills/opengame-deploy/references/json-events.md +6 -5
- package/dist/skills/opengame-deploy/references/packaging.md +28 -26
- package/dist/skills/opengame-depth/SKILL.md +61 -33
- package/dist/skills/opengame-enemies/SKILL.md +96 -40
- package/dist/skills/opengame-enemies/references/pacing-and-bots.md +108 -0
- package/dist/skills/opengame-enemies/references/threejs.md +59 -0
- package/dist/skills/opengame-front-end/SKILL.md +85 -39
- package/dist/skills/opengame-front-end/references/menus.md +42 -8
- package/dist/skills/opengame-game-feel/SKILL.md +95 -47
- package/dist/skills/opengame-game-feel/references/feel-numbers.md +59 -0
- package/dist/skills/opengame-game-feel/references/killcam.md +88 -0
- package/dist/skills/opengame-jam/SKILL.md +42 -27
- package/dist/skills/opengame-lighting/SKILL.md +85 -34
- package/dist/skills/opengame-loading/SKILL.md +78 -38
- package/dist/skills/opengame-loading/helpers/loading-count.mjs +115 -0
- package/dist/skills/opengame-loading/references/threejs.md +32 -7
- package/dist/skills/opengame-look/SKILL.md +122 -51
- package/dist/skills/opengame-look/references/matching-a-reference.md +73 -0
- package/dist/skills/opengame-look/references/painterly.md +69 -0
- package/dist/skills/opengame-look/references/post-and-lens.md +10 -3
- package/dist/skills/opengame-maps/SKILL.md +78 -0
- package/dist/skills/opengame-maps/references/map-spec.md +77 -0
- package/dist/skills/opengame-mobile/SKILL.md +18 -18
- package/dist/skills/opengame-montage-make/SKILL.md +187 -0
- package/dist/skills/opengame-montage-make/references/briefs.md +293 -0
- package/dist/skills/opengame-montage-make/references/day-one-questions.md +46 -0
- package/dist/skills/opengame-montage-make/references/edge-cases.md +27 -0
- package/dist/skills/opengame-montage-make/references/filmable.md +244 -0
- package/dist/skills/opengame-montage-make/references/finishing.md +126 -0
- package/dist/skills/opengame-montage-make/references/measure.md +282 -0
- package/dist/skills/opengame-montage-make/references/montage-capture.md +151 -0
- package/dist/skills/opengame-montage-make/references/montage-gates.md +84 -0
- package/dist/skills/opengame-montage-make/references/montage-genres.md +198 -0
- package/dist/skills/opengame-montage-make/references/montage-grammar.md +320 -0
- package/dist/skills/opengame-montage-make/references/montage-ops.md +127 -0
- package/dist/skills/opengame-montage-make/references/og-snipers-record.md +110 -0
- package/dist/skills/opengame-montage-make/references/owner-eye.md +214 -0
- package/dist/skills/opengame-montage-make/references/reference-study.md +293 -0
- package/dist/skills/opengame-montage-make/references/song.md +64 -0
- package/dist/skills/opengame-montage-plan/SKILL.md +197 -0
- package/dist/skills/opengame-montage-plan/references/briefs.md +293 -0
- package/dist/skills/opengame-montage-plan/references/day-one-questions.md +46 -0
- package/dist/skills/opengame-montage-plan/references/filmable.md +244 -0
- package/dist/skills/opengame-montage-plan/references/measure.md +282 -0
- package/dist/skills/opengame-montage-plan/references/montage-capture.md +151 -0
- package/dist/skills/opengame-montage-plan/references/montage-gates.md +84 -0
- package/dist/skills/opengame-montage-plan/references/montage-genres.md +198 -0
- package/dist/skills/opengame-montage-plan/references/montage-grammar.md +320 -0
- package/dist/skills/opengame-montage-plan/references/montage-ops.md +127 -0
- package/dist/skills/opengame-montage-plan/references/og-snipers-record.md +110 -0
- package/dist/skills/opengame-montage-plan/references/owner-eye.md +214 -0
- package/dist/skills/opengame-montage-plan/references/reference-study.md +293 -0
- package/dist/skills/opengame-montage-plan/references/song.md +64 -0
- package/dist/skills/opengame-montage-review-and-improve/SKILL.md +178 -0
- package/dist/skills/opengame-montage-review-and-improve/references/briefs.md +293 -0
- package/dist/skills/opengame-montage-review-and-improve/references/day-one-questions.md +46 -0
- package/dist/skills/opengame-montage-review-and-improve/references/filmable.md +244 -0
- package/dist/skills/opengame-montage-review-and-improve/references/finishing.md +126 -0
- package/dist/skills/opengame-montage-review-and-improve/references/measure.md +282 -0
- package/dist/skills/opengame-montage-review-and-improve/references/montage-capture.md +151 -0
- package/dist/skills/opengame-montage-review-and-improve/references/montage-gates.md +84 -0
- package/dist/skills/opengame-montage-review-and-improve/references/montage-genres.md +198 -0
- package/dist/skills/opengame-montage-review-and-improve/references/montage-grammar.md +320 -0
- package/dist/skills/opengame-montage-review-and-improve/references/montage-ops.md +127 -0
- package/dist/skills/opengame-montage-review-and-improve/references/og-snipers-record.md +110 -0
- package/dist/skills/opengame-montage-review-and-improve/references/owner-eye.md +214 -0
- package/dist/skills/opengame-montage-review-and-improve/references/reference-study.md +293 -0
- package/dist/skills/opengame-montage-review-and-improve/references/song.md +64 -0
- package/dist/skills/opengame-multiplayer/SKILL.md +143 -0
- package/dist/skills/opengame-multiplayer/references/bot-lobbies.md +71 -0
- package/dist/skills/opengame-multiplayer/references/netcode.md +165 -0
- package/dist/skills/opengame-performance/SKILL.md +106 -65
- package/dist/skills/opengame-performance/helpers/landing-pacer.mjs +86 -0
- package/dist/skills/opengame-performance/references/measuring.md +51 -0
- package/dist/skills/opengame-performance/references/webgpu.md +86 -0
- package/dist/skills/opengame-production/SKILL.md +119 -54
- package/dist/skills/opengame-production/references/team.md +107 -0
- package/dist/skills/opengame-production/references/templates.md +106 -16
- package/dist/skills/opengame-quality-bar/SKILL.md +94 -42
- package/dist/skills/opengame-quality-bar/references/cheap-tells.md +14 -7
- package/dist/skills/opengame-quality-bar/references/judges.md +95 -0
- package/dist/skills/opengame-quality-bar/references/review-prompt.md +10 -5
- package/dist/skills/opengame-rhythm/SKILL.md +138 -0
- package/dist/skills/opengame-rhythm/references/charting.md +109 -0
- package/dist/skills/opengame-rhythm/references/timing.md +92 -0
- package/dist/skills/opengame-router/SKILL.md +10 -2
- package/dist/skills/opengame-scene-audit/SKILL.md +64 -47
- package/dist/skills/opengame-scene-audit/helpers/scene-audit.js +97 -19
- package/dist/skills/opengame-sdk/SKILL.md +26 -9
- package/dist/skills/opengame-sdk/references/engines.md +2 -2
- package/dist/skills/opengame-sdk/references/identity.md +10 -11
- package/dist/skills/opengame-stability/SKILL.md +59 -27
- package/dist/skills/opengame-trailer-make/SKILL.md +164 -0
- package/dist/skills/opengame-trailer-make/references/archetypes.md +113 -0
- package/dist/skills/opengame-trailer-make/references/briefs.md +273 -0
- package/dist/skills/opengame-trailer-make/references/core.md +129 -0
- package/dist/skills/opengame-trailer-make/references/craft.md +299 -0
- package/dist/skills/opengame-trailer-make/references/edge-cases.md +27 -0
- package/dist/skills/opengame-trailer-make/references/filmable.md +244 -0
- package/dist/skills/opengame-trailer-make/references/finishing.md +126 -0
- package/dist/skills/opengame-trailer-make/references/gates.md +184 -0
- package/dist/skills/opengame-trailer-make/references/measure.md +282 -0
- package/dist/skills/opengame-trailer-make/references/music.md +148 -0
- package/dist/skills/opengame-trailer-make/references/og-clash-record.md +133 -0
- package/dist/skills/opengame-trailer-make/references/ops.md +154 -0
- package/dist/skills/opengame-trailer-make/references/owner-eye.md +214 -0
- package/dist/skills/opengame-trailer-make/references/review.md +141 -0
- package/dist/skills/opengame-trailer-make/references/title.md +92 -0
- package/dist/skills/opengame-trailer-plan/SKILL.md +176 -0
- package/dist/skills/opengame-trailer-plan/references/archetypes.md +113 -0
- package/dist/skills/opengame-trailer-plan/references/briefs.md +273 -0
- package/dist/skills/opengame-trailer-plan/references/core.md +129 -0
- package/dist/skills/opengame-trailer-plan/references/craft.md +299 -0
- package/dist/skills/opengame-trailer-plan/references/edge-cases.md +27 -0
- package/dist/skills/opengame-trailer-plan/references/filmable.md +244 -0
- package/dist/skills/opengame-trailer-plan/references/finishing.md +126 -0
- package/dist/skills/opengame-trailer-plan/references/gates.md +184 -0
- package/dist/skills/opengame-trailer-plan/references/measure.md +282 -0
- package/dist/skills/opengame-trailer-plan/references/music.md +148 -0
- package/dist/skills/opengame-trailer-plan/references/og-clash-record.md +133 -0
- package/dist/skills/opengame-trailer-plan/references/ops.md +154 -0
- package/dist/skills/opengame-trailer-plan/references/owner-eye.md +214 -0
- package/dist/skills/opengame-trailer-plan/references/reference-set.md +92 -0
- package/dist/skills/opengame-trailer-plan/references/review.md +141 -0
- package/dist/skills/opengame-trailer-plan/references/title.md +92 -0
- package/dist/skills/opengame-trailer-review-and-improve/SKILL.md +145 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/archetypes.md +113 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/briefs.md +273 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/core.md +129 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/craft.md +299 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/edge-cases.md +27 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/filmable.md +244 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/finishing.md +126 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/gates.md +184 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/measure.md +282 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/music.md +148 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/og-clash-record.md +133 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/ops.md +154 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/owner-eye.md +214 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/review.md +141 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/title.md +92 -0
- package/dist/skills/opengame-verification/SKILL.md +113 -48
- package/dist/skills/opengame-weapons/SKILL.md +129 -55
- package/dist/skills/opengame-weapons/references/handling-numbers.md +42 -0
- package/dist/skills/opengame-weapons/references/reloads-and-hands.md +96 -0
- package/dist/skills/opengame-weapons/references/sights-and-scopes.md +98 -0
- package/dist/skills/opengame-weapons/references/threejs.md +71 -0
- package/dist/skills/opengame-world-physics/SKILL.md +55 -24
- package/dist/skills/opengame-world-physics/references/measured-failures.md +28 -1
- package/package.json +1 -1
package/dist/skills/opengame-all-in-one/references/opengame-weapons/references/handling-numbers.md
ADDED
|
@@ -0,0 +1,114 @@
|
|
|
1
|
+
# Handling numbers from OC
|
|
2
|
+
|
|
3
|
+
Reference configurations from OC, a first-person wave shooter with a boss. Most were
|
|
4
|
+
taken from the CoD games it imitated, World at War and Black Ops above all. Use them as a
|
|
5
|
+
starting point for a game of the same kind, then tune with frame recordings.
|
|
6
|
+
|
|
7
|
+
## Recoil springs per class
|
|
8
|
+
|
|
9
|
+
| Class | Frequency | Damping ratio |
|
|
10
|
+
|---|---|---|
|
|
11
|
+
| SMG | 8.2 Hz | 0.62 |
|
|
12
|
+
| Assault rifle | 6.6 Hz | 0.58 |
|
|
13
|
+
| LMG | 4.6 Hz | 0.50 |
|
|
14
|
+
| Sniper | 3.4 Hz | 0.46 |
|
|
15
|
+
| Shotgun | 4.0 Hz | 0.48 |
|
|
16
|
+
| Pistol | 9.5 Hz | 0.66 |
|
|
17
|
+
|
|
18
|
+
Aimed: frequency x1.25, damping to 1.0 (critically damped), pitch x0.15, push x0.32.
|
|
19
|
+
Caps: position z 0.070, y 0.026, x 0.020; rotation x 0.30, y 0.10, z 0.16 rad. Each gun
|
|
20
|
+
scales its class between 0.55x and 1.8x. The first three shots follow a fixed pattern,
|
|
21
|
+
as in BO6.
|
|
22
|
+
|
|
23
|
+
## Spray
|
|
24
|
+
|
|
25
|
+
Rounds 1 to 3 go straight up. Rounds 4 to 10 follow the gun's own sway curve. From round
|
|
26
|
+
11 the pattern goes flatter (0.67x) and wider (1.3x). Random noise went from 35% to 20%.
|
|
27
|
+
OC's notes record the first shot at 25% horizontal and a 65% per-gun wander after it.
|
|
28
|
+
|
|
29
|
+
## Times
|
|
30
|
+
|
|
31
|
+
| Action | Time |
|
|
32
|
+
|---|---|
|
|
33
|
+
| Aim in, World at War | 0.245 s |
|
|
34
|
+
| Aim out, World at War | 0.25 s |
|
|
35
|
+
| Aim, pistol | 0.19 s |
|
|
36
|
+
| Aim, SMG | 0.21 to 0.28 s |
|
|
37
|
+
| Aim, assault rifle | 0.26 to 0.32 s |
|
|
38
|
+
| Aim, sniper | 0.34 to 0.46 s |
|
|
39
|
+
| Aim, LMG | 0.39 to 0.48 s |
|
|
40
|
+
| Swap raise and lower | 0.25 s |
|
|
41
|
+
| First draw from a machine | 0.8 s |
|
|
42
|
+
| Equip / holster / inspect | 0.35 s / 0.13 s / 3.0 s |
|
|
43
|
+
| Kick settles | 0.15 to 0.2 s inside a 330 ms cadence |
|
|
44
|
+
|
|
45
|
+
Aiming is a smoothstep, `3p^2 - 2p^3`, over exactly the gun's aim time, reversible
|
|
46
|
+
mid-raise. A flat 165 ms for every gun was the defect it replaced. Sprint pose blends in
|
|
47
|
+
at rate 7 and out at 14. Aimed kick is 30 to 40% of hip kick.
|
|
48
|
+
|
|
49
|
+
## Damage and fire rate
|
|
50
|
+
|
|
51
|
+
- Real fire rates: MG42 1,200 rpm, a revolver 120 rpm.
|
|
52
|
+
- Hit zones: head 2.0, chest 1.0, arm 0.9, leg 0.85.
|
|
53
|
+
- Audit time to kill per gun at rounds 1, 10, 20 and 30. Upgraded automatics kill a
|
|
54
|
+
round-30 zombie in 0.65 to 1.0 s of headshots. One revolver had done 1,000 damage at
|
|
55
|
+
625 rpm before the audit.
|
|
56
|
+
|
|
57
|
+
## Shots
|
|
58
|
+
|
|
59
|
+
- Muzzle flash 0.045 s sprite with a 0.055 s point light, from the muzzle socket, never
|
|
60
|
+
the hand; two frames; a white-hot core, never an opaque cone.
|
|
61
|
+
- Shells eject from an ejection socket with gravity 11 and a 2.2 s life. On high fire
|
|
62
|
+
rates OC dropped a casing every 6th round and capped simultaneous fire sounds at 2.
|
|
63
|
+
- Tracer pool of 28, cores at least 3.2 px with a 12 px glow.
|
|
64
|
+
|
|
65
|
+
## Assets
|
|
66
|
+
|
|
67
|
+
- Hero guns: about 24k triangles in first person (2048 base colour, 1024 metal and
|
|
68
|
+
roughness, 2048 normal) and about 10k in the world (512), with named moving parts,
|
|
69
|
+
`socket_*` empties and a manifest of pivots, reload travel and sight data.
|
|
70
|
+
- Wonder weapons: the same fidelity, 20 to 25k triangles, at or below the heaviest
|
|
71
|
+
loadout gun.
|
|
72
|
+
- AO baked into the packed material, cavity 0.2 to 0.4; normals at least 1024 px.
|
|
73
|
+
|
|
74
|
+
# Handling numbers from OS
|
|
75
|
+
|
|
76
|
+
OS is a first-person, snipers-only free-for-all with bots. Its owner's bar was the
|
|
77
|
+
quickscoping of the reference games; these numbers met it in the owner's hands.
|
|
78
|
+
|
|
79
|
+
- Aim: lens and hands share 220 ms in and 70 ms out, zoom on the press frame. The
|
|
80
|
+
quickscope bar was about 0.27 s where the reference data said 0.40 s, and no perk
|
|
81
|
+
speeds aiming up.
|
|
82
|
+
- A swap is usable in the middle of a bolt cycle. Cancels run on elapsed time "so 20 fps
|
|
83
|
+
and 144 fps decide a press the same way".
|
|
84
|
+
- Aim assist on pads only, fitted to the reference game's measured envelope rather than
|
|
85
|
+
a research table (strafe slip 3.9 to 0.1 degrees).
|
|
86
|
+
- A per-frame camera trace took recoil overshoot from 16% to 3%.
|
|
87
|
+
- Rounds pass anything thinner than 0.6 m at -25% damage per wall, at most 2 walls (1 for
|
|
88
|
+
bots) and two bodies; rock and terrain stop them. Bullets and bodies use separate
|
|
89
|
+
collision categories, and what can be seen through can be shot through.
|
|
90
|
+
- Hit markers fire only on scored damage, from one damage event that the HUD never
|
|
91
|
+
recomputes.
|
|
92
|
+
- Owner-locked: 7 to 10 rounds a magazine and infinite reserve; pickup by pressing, not
|
|
93
|
+
holding.
|
|
94
|
+
- Sniper-only rules: a quickscope is a kill within 0.35 s of full zoom; a no-scope means
|
|
95
|
+
no aiming in the last second; the multikill window is sized to the bolt cycle; scope
|
|
96
|
+
glint shows only after 250 ms scoped, within 20 degrees of the victim's view and beyond
|
|
97
|
+
25 m, a counter to camping.
|
|
98
|
+
|
|
99
|
+
# Handling numbers from LC
|
|
100
|
+
|
|
101
|
+
LC is a body-camera survival shooter with 73 weapons, a camera on the player's chest and
|
|
102
|
+
weight-driven recoil.
|
|
103
|
+
|
|
104
|
+
- Recoil from the weapon's mass: kick = 0.5 x impulse / kg^0.72 x brace x (1 - steady).
|
|
105
|
+
View impulse per round: back 0.9 + 0.9 kick, pitch 5 + 9 kick, random roll 3 + 8 drift,
|
|
106
|
+
scaled 1 / (0.6 + 0.35 kg), and x(1 - 0.45) on the sights.
|
|
107
|
+
- Brass: the slide goes back in 13 ms and home in 54, the case leaves 7 ms after the
|
|
108
|
+
round and lands about 2 m right, with a sound per bounce. Brass is dull metal: three
|
|
109
|
+
bright cases read as "three fat white cylinders glowing in a dark hall".
|
|
110
|
+
- Movement: walk 3.1 m/s, sprint 6.3 (7.0 with a perk), winded 4.3, crouch 1.55;
|
|
111
|
+
acceleration 15 and deceleration 18 m/s^2; sights slow movement to 0.58x.
|
|
112
|
+
- Weapon data checked row by row against a published source: 26 rows corrected.
|
|
113
|
+
- Grenades and launchers were removed at the owner's word, with a test that fires every
|
|
114
|
+
gun and fails on any blast.
|
package/dist/skills/opengame-all-in-one/references/opengame-weapons/references/reloads-and-hands.md
ADDED
|
@@ -0,0 +1,96 @@
|
|
|
1
|
+
# Reloads and hands in the player's picture
|
|
2
|
+
|
|
3
|
+
How LC and OS staged reloads and kept hands on the gun, for "Each reload is climbed gun
|
|
4
|
+
by gun" and "Hands keep one size and one material" in `SKILL.md`. LC used a camera on
|
|
5
|
+
the player's chest; OS a conventional eye camera. Numbers are theirs; measure your own.
|
|
6
|
+
|
|
7
|
+
## The ledger
|
|
8
|
+
|
|
9
|
+
One row per weapon, two reloads per row (empty and with rounds left), refitted versions
|
|
10
|
+
too. Seven points scored 0 to 10, pass at 9 on every one:
|
|
11
|
+
|
|
12
|
+
| Point | What it asks |
|
|
13
|
+
|---|---|
|
|
14
|
+
| Drill | The real sequence for this mechanism, in order, nothing skipped |
|
|
15
|
+
| Picture | The work is in frame, the weapon under a third of the picture, the work in its lower third |
|
|
16
|
+
| Hands | A hand is at work through the reload; each action begins and ends with a hand travelling |
|
|
17
|
+
| Wrists | Wrists, elbows and forearms inside the natural band (`opengame-characters`) |
|
|
18
|
+
| Motion | Nothing pops, teleports, slides on rails or whirls over the lens, at 60 fps |
|
|
19
|
+
| Parts | Moving parts are separate objects and really move |
|
|
20
|
+
| Light | The work is lit; gloves are never the brightest thing in frame |
|
|
21
|
+
|
|
22
|
+
Hard limits LC added: sleeve and glove together under a sixth of the picture; no finger
|
|
23
|
+
through metal deeper than 1.5 mm; wrist within 70 degrees bent and 30 to the side (a
|
|
24
|
+
simpler pair than the per-axis joint limits in `opengame-characters`, which also apply).
|
|
25
|
+
Each fault names the stream or file that owns it. Read the films at speed first, then at
|
|
26
|
+
a quarter speed. Calibrate the ledger against the owner: LC's owner accepted all eight
|
|
27
|
+
pistols while the tester had scored the M1911 6/7/5/7/4/5/5; the director's reading was that
|
|
28
|
+
the owner judges the whole act at speed in the player's own picture, not a fingertip at
|
|
29
|
+
one frame. When the owner
|
|
30
|
+
passes what the bar fails, move the bar.
|
|
31
|
+
|
|
32
|
+
## Staging (LC)
|
|
33
|
+
|
|
34
|
+
- **Stance by the magazine well.** Place the weapon so the well sits in the picture, not
|
|
35
|
+
so the hand is comfortable.
|
|
36
|
+
- **Cant long arms toward the lens** and keep the cant through the stage: rolled 1.2 rad,
|
|
37
|
+
12 cm out, 6 cm right, muzzle up 0.15 rad. A canted M16 took 7.7% of the picture;
|
|
38
|
+
upright it took 19 to 20%. Never swing a long gun through end-on: 12 end-on frames read
|
|
39
|
+
as the rifle flicked over the lens.
|
|
40
|
+
- **Nothing within 25 cm of the lens** while a long arm is staged for a reload, stricter
|
|
41
|
+
than the 9 to 16 cm floors that hold at rest (`SKILL.md`, the lens floor rule).
|
|
42
|
+
- **Hand paths are timed** round the weapon, 0.25 to 0.33 s, and any target jump over
|
|
43
|
+
8 cm becomes a timed, eased travel (an M1897 hand had teleported 305 mm).
|
|
44
|
+
- **Hand parts over as the hand arrives, never by the clock.**
|
|
45
|
+
- **The magazine leaves empty and arrives full** through one carried part and a draw
|
|
46
|
+
range on its rounds, its mouth within about 40 degrees of the lens for 6 frames.
|
|
47
|
+
- **A rock when a magazine is torn out** and a kick when a bolt runs forward: 8 to 10 mm
|
|
48
|
+
and 4 degrees, doubled because 10 px of 1790 did not read.
|
|
49
|
+
- **Empty and tactical differ**: on an empty pistol the slide sits on its stop, is drawn
|
|
50
|
+
overhand, and is released 0.15 s after the rack event.
|
|
51
|
+
- **Every action begins and ends with a hand travelling**, about a third of a second in
|
|
52
|
+
and a third out, eased, so nothing appears or vanishes. This is what made the pistol
|
|
53
|
+
reload the one the owner accepted.
|
|
54
|
+
- **Light the work.** Reloads indoors went near-dark because the chest lamp lit the wall
|
|
55
|
+
above the hands: "a dark picture through a reload does not stand".
|
|
56
|
+
- **Check the mesh first.** A cocking handle fused into the receiver cost two leads
|
|
57
|
+
eleven placings; cut moving parts out by boolean (the magazine whole with its end
|
|
58
|
+
walls, handles whole) before animating any hand.
|
|
59
|
+
|
|
60
|
+
## Contact audit (OS)
|
|
61
|
+
|
|
62
|
+
Rebuild logged frames from the real models offline and measure how far each glove
|
|
63
|
+
vertex sits inside the gun, past the glove's own idle penetration. OS flagged clips over
|
|
64
|
+
6 mm. It found bolt handles rotating into the stock (fixed by a table of bolt-handle positions per rifle), a
|
|
65
|
+
reload path 16 cm under the rifle and a hand path through the optic; clipped game time fell from
|
|
66
|
+
about 24 s to 11 s. The test driver pulsed bolt presses every 0.6 s because the engine ignored
|
|
67
|
+
presses mid-rechamber.
|
|
68
|
+
|
|
69
|
+
- Sample every frame. Eight frames per bolt missed a black patch on the mitten through
|
|
70
|
+
30% of the cycle on 7 rifles.
|
|
71
|
+
- Log the drawn glove scale every frame. One scale held: exactly 1.1 over 15,382 frames.
|
|
72
|
+
- Paint back faces one colour in a debug view to find exposed interiors.
|
|
73
|
+
- One material and one fill light for hands in every state: fists and armed gloves had
|
|
74
|
+
differed 5x in fill.
|
|
75
|
+
|
|
76
|
+
## Finger solve (LC)
|
|
77
|
+
|
|
78
|
+
- Named skin patches (web, palm, heel, thenar) placed at millimetre positions on the
|
|
79
|
+
weapon's own vertices; a six-degree-of-freedom search per finger, each closed until
|
|
80
|
+
every bone bears; the thumb searched from 729 seeds; the support hand solved over the
|
|
81
|
+
firing hand's glove.
|
|
82
|
+
- Pass: nothing deeper than 1.5 mm, counted over every vertex. A bounding-volume inside
|
|
83
|
+
test was trusted only within 8 mm.
|
|
84
|
+
- Count on the game's own rig: the solver's 2.9 mm was 7.9 mm on the game's stretched
|
|
85
|
+
forearm.
|
|
86
|
+
- Fix a bent wrist by moving the elbow, not the hand (`opengame-characters`).
|
|
87
|
+
|
|
88
|
+
## The glove itself (LC)
|
|
89
|
+
|
|
90
|
+
A photoreal style needed five-finger gloves. LC built them by script from a CC0 human
|
|
91
|
+
base: the glove as a design in fields measured from the bone frames, about 1,000
|
|
92
|
+
stitches as geometry sunk in a trough, a sleeve draped by a cloth solver at a 105 degree
|
|
93
|
+
elbow and un-skinned back to rest, a tight-elbow morph, five baked maps at 4096 and a
|
|
94
|
+
closed-hand fold map blended finger by finger. 14.1k triangles a glove, 12.7k a sleeve.
|
|
95
|
+
"Nothing regular": every repeat has a wobble on its phase. A stylised game can use a
|
|
96
|
+
thumb and a mitten instead (`opengame-characters`).
|
package/dist/skills/opengame-all-in-one/references/opengame-weapons/references/sights-and-scopes.md
ADDED
|
@@ -0,0 +1,98 @@
|
|
|
1
|
+
# Sights and scopes
|
|
2
|
+
|
|
3
|
+
How OS and LC met "Aiming goes through a real sight picture" and "Scope-in registers
|
|
4
|
+
from the press" in `SKILL.md`. OS is a snipers-only shooter on a wasm engine with
|
|
5
|
+
WebGPU; LC is a body-camera shooter in three.js WebGPU. Their numbers worked there;
|
|
6
|
+
measure your own.
|
|
7
|
+
|
|
8
|
+
## One progress value
|
|
9
|
+
|
|
10
|
+
Field of view, weapon offset and look sensitivity all read one eased aim progress `p`
|
|
11
|
+
from 0 to 1. Separate curves read as the gun sliding "left to straight" while the view
|
|
12
|
+
zooms.
|
|
13
|
+
|
|
14
|
+
- Zoom starts on the press frame. OS: lens and hands share 220 ms in and 70 ms out.
|
|
15
|
+
- Ease the field of view in tan space, not in degrees, so the zoom rate looks even.
|
|
16
|
+
- Sensitivity follows the field of view: the look slows by the same ratio the picture
|
|
17
|
+
narrows. LC narrows 1.35x for long arms and 1.6x for pistols.
|
|
18
|
+
- Fire from the rendered view on the press, never from where the camera will be once
|
|
19
|
+
the ease finishes. OS's shots 100 to 200 ms into a scope-in had landed 2 to 2.7 degrees
|
|
20
|
+
below the crosshair.
|
|
21
|
+
- Release is at least as fast as the press, and reversal mid-raise starts from the current
|
|
22
|
+
`p`. The owner asked for aim-out as fast as aim-in; OS's 70 ms out is faster.
|
|
23
|
+
|
|
24
|
+
## Two optic classes (OS)
|
|
25
|
+
|
|
26
|
+
- **Full-screen scopes** hide the view model at a fixed `p` (OS: 0.5) and draw the scope
|
|
27
|
+
image at the same radius the eyepiece had in the frame before the cut, so the aperture
|
|
28
|
+
does not jump (it had jumped over 2x; after, about 5%). The glass fills about 80% of
|
|
29
|
+
frame height (864 to 886 px at 1080p) and its markings draw even with the HUD hidden.
|
|
30
|
+
- **See-through optics** keep the real optic in the frame and zoom the world by
|
|
31
|
+
`M = tan(play / 2) / tan(ads / 2)`, computed against the actual play lens (OS's
|
|
32
|
+
3.71x became 4.00x once computed against the 66 degree lens rather than a nominal
|
|
33
|
+
one). Cut camo glow from the sight picture (14 of 283 frames to 0), keep the map
|
|
34
|
+
visible around the optic, and lock the reticle under recoil.
|
|
35
|
+
|
|
36
|
+
## Tune and judge at the range of use
|
|
37
|
+
|
|
38
|
+
At 4 to 10x a surface 40 m away reads as 4 to 10 m away, so a scope is judged where it
|
|
39
|
+
is used. OS tuned each map's scope field of view to frame a standing target at that
|
|
40
|
+
map's signature range (53 to 236 m) and captured scoped frames at 100 to 300 m; its
|
|
41
|
+
judges had scored scope shots taken 4 to 23 m from a wall for about 40 builds.
|
|
42
|
+
|
|
43
|
+
## What a scope must not cost
|
|
44
|
+
|
|
45
|
+
- A scope is a field-of-view change plus an overlay, never a second world render. OS:
|
|
46
|
+
about 0.4 ms against a no-ADS control.
|
|
47
|
+
- Hold the render scale and render targets fixed across the cut. A resolution change at
|
|
48
|
+
scope-in re-created 46 to 70 textures and 250 to 450 bind groups, seen only in a WebGPU
|
|
49
|
+
call trace after the CPU profile showed nothing; the owner saw "a weird frame".
|
|
50
|
+
- Cast long rangefinder rays only while zoomed, in growing spans (OS: 32, 128, 512 m).
|
|
51
|
+
A 1.2 km ray every frame had peaked at 123 ms; after, under 0.14 ms.
|
|
52
|
+
|
|
53
|
+
## Magnified artefacts
|
|
54
|
+
|
|
55
|
+
A scope magnifies whatever the hip view hid.
|
|
56
|
+
|
|
57
|
+
- Clamp glass sharpening to its neighbourhood (OS: 4,492 spike pixels to 698).
|
|
58
|
+
- Use hard shadows while scoped: soft penumbra "only resolves under TAA, which the
|
|
59
|
+
scope's sway and narrow FOV prevent".
|
|
60
|
+
- Draw an open tube's back faces as a dark bore; they had caught the rim light (3,800
|
|
61
|
+
cyan pixels).
|
|
62
|
+
- Scope tubes need 48 or more radial segments to read round (OC).
|
|
63
|
+
- A 2 to 3 px red dot was unreadable, and a 0.8 mm glowing torus bloomed into a
|
|
64
|
+
seven-ring flower (OC): draw reticles in a shader.
|
|
65
|
+
|
|
66
|
+
## The sight line (LC)
|
|
67
|
+
|
|
68
|
+
- Publish per weapon: rear sight point, front sight point, bore axis, eye relief.
|
|
69
|
+
- Lens position = rear sight - bore direction x relief. The body follows the eye; the
|
|
70
|
+
gun never moves to meet a fixed camera.
|
|
71
|
+
- Eye relief: handgun at real reach (43 cm), open sights 30 to 40 cm, apertures 6 to
|
|
72
|
+
15 cm; 6 to 50 cm across LC's 73 weapons.
|
|
73
|
+
- The weapon comes square to the lens axis: rear sight within 1 mm of the axis, bore
|
|
74
|
+
within 4 cm at 10 m. Each clip's rear sight, front post and the round at 25 m lie
|
|
75
|
+
within 3 px of one line.
|
|
76
|
+
- Open sight notches (2.8 to 3.6 mm) and apertures (5 mm in an 11 mm ring) were cut by a
|
|
77
|
+
tool on packed meshes in seconds, after generated guns arrived with solid sights.
|
|
78
|
+
- Keep the firing hand out of the picture on long guns: 69 of 73 guns lined up within
|
|
79
|
+
4 px while 56 still showed the firing hand at 10 to 19 cm.
|
|
80
|
+
- Check what stands beside the notch, not only above its floor: a finger-over-the-sight
|
|
81
|
+
check passed while the owner saw a finger cover the aim.
|
|
82
|
+
- LC focuses depth of field on the front post of open sights; the field of view narrows
|
|
83
|
+
1.25 to 1.35x in its first version.
|
|
84
|
+
|
|
85
|
+
## Bolts and the scope
|
|
86
|
+
|
|
87
|
+
Never make the player release aim to cycle a bolt, reload or fire again. OS kept the
|
|
88
|
+
rifle on the eye through the bolt at the owner's call ("u shouldnt force people to zoom
|
|
89
|
+
out to pull the bolt"); LC's realistic hold works the bolt with the rifle off the eye
|
|
90
|
+
and brings it back while aim is held. An agent had added a forced unscope "as in" the
|
|
91
|
+
reference games, from memory: the owner's feel beats canon recalled from memory.
|
|
92
|
+
|
|
93
|
+
## Benches
|
|
94
|
+
|
|
95
|
+
- Real inputs at fixed delays after the press (0 to 250 ms) and fixed ranges (50 to
|
|
96
|
+
200 m), counted per 12 shots. OS: 0 to 2 of 12 became 12 of 12 from 100 ms.
|
|
97
|
+
- A 120 fps strip of scope-in, fire, bolt and release, read frame by frame. A bench
|
|
98
|
+
proves registration, not feel; the owner's hands judge the feel.
|
|
@@ -0,0 +1,240 @@
|
|
|
1
|
+
# Weapons in three.js
|
|
2
|
+
|
|
3
|
+
The engine-agnostic rules are in `SKILL.md`. This file is how to meet them in three.js.
|
|
4
|
+
Numbers are OC's unless another game is named.
|
|
5
|
+
|
|
6
|
+
## A separate view model scene and camera
|
|
7
|
+
|
|
8
|
+
Render the world, clear depth, then render the view model with its own camera. The view
|
|
9
|
+
model never clips into walls because the world's depth is gone when it draws, and its
|
|
10
|
+
lens does not follow the FOV slider.
|
|
11
|
+
|
|
12
|
+
```js
|
|
13
|
+
const viewScene = new THREE.Scene()
|
|
14
|
+
const viewCamera = new THREE.PerspectiveCamera(75, aspect, 0.012, 10) // fixed FOV, tiny near
|
|
15
|
+
renderer.autoClear = false
|
|
16
|
+
|
|
17
|
+
function frame() {
|
|
18
|
+
renderer.clear()
|
|
19
|
+
renderer.render(worldScene, worldCamera) // world FOV from the slider, 65 to 110
|
|
20
|
+
renderer.clearDepth() // the view model ignores world depth
|
|
21
|
+
renderer.render(viewScene, viewCamera)
|
|
22
|
+
}
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
- Copy the world camera's rotation into the view camera each frame, before sway and kick
|
|
26
|
+
are added to the gun, so shots still leave along the world camera's ray.
|
|
27
|
+
- On resize, update both cameras' `aspect` and call `updateProjectionMatrix()` on both.
|
|
28
|
+
Only the world camera's `fov` follows the settings slider.
|
|
29
|
+
- Aiming changes the view camera's FOV with the gun's own aim time (OC: 75 to 58.5
|
|
30
|
+
degrees), not the world FOV slider.
|
|
31
|
+
- Move the world camera's near plane out (DK used 0.15) once the view model has its own
|
|
32
|
+
near plane; it buys depth precision for the world.
|
|
33
|
+
|
|
34
|
+
## Depth and post-processing
|
|
35
|
+
|
|
36
|
+
- Run depth-reading world passes (SSAO, depth of field, fog, motion blur) on the world
|
|
37
|
+
scene only, then draw the view model. In `EffectComposer`, add a second `RenderPass`
|
|
38
|
+
for `viewScene` with `clear = false` and `clearDepth = true`, after the world's
|
|
39
|
+
depth-reading passes and before the output pass.
|
|
40
|
+
- Motion blur on the world with the gun sharp is OC's default. Keep the view model out
|
|
41
|
+
of any velocity buffer.
|
|
42
|
+
- Do not let the view model cast shadows into the world. A third-person world model of
|
|
43
|
+
the same gun casts them instead.
|
|
44
|
+
- Bloom runs after both, so clamp the view model's emissive (reticles, wonder glow)
|
|
45
|
+
before tonemapping. A 0.8 mm glowing torus bloomed into a seven-ring flower; draw
|
|
46
|
+
reticles in a shader instead.
|
|
47
|
+
|
|
48
|
+
## Light and environment for the view model
|
|
49
|
+
|
|
50
|
+
The view model gets its own environment and a small rig so it never goes black in a
|
|
51
|
+
backlit world.
|
|
52
|
+
|
|
53
|
+
```js
|
|
54
|
+
import { RoomEnvironment } from 'three/addons/environments/RoomEnvironment.js'
|
|
55
|
+
const pmrem = new THREE.PMREMGenerator(renderer)
|
|
56
|
+
viewScene.environment = pmrem.fromScene(new RoomEnvironment(), 0.04).texture
|
|
57
|
+
viewScene.add(new THREE.HemisphereLight(0xdfe8ff, 0x302820, 0.6))
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
OC's studio environment gave 41% of the gun's mean brightness, and the two directional
|
|
61
|
+
lights about 3 luma. Clone materials per held gun (`material.clone()`) so a menu preview
|
|
62
|
+
or a camo swap never changes a shared material.
|
|
63
|
+
|
|
64
|
+
## Coverage masks for view model size
|
|
65
|
+
|
|
66
|
+
Render the view model alone to a small target with a flat override material and count
|
|
67
|
+
the lit pixels. Run it per gun at hip, aimed, sprinting and drawing, at 1280 x 720,
|
|
68
|
+
1920 x 1080 and 844 x 390.
|
|
69
|
+
|
|
70
|
+
```js
|
|
71
|
+
const target = new THREE.WebGLRenderTarget(w, h)
|
|
72
|
+
const flat = new THREE.MeshBasicMaterial({ color: 0xffffff })
|
|
73
|
+
viewScene.overrideMaterial = flat
|
|
74
|
+
renderer.setRenderTarget(target)
|
|
75
|
+
renderer.setClearColor(0x000000, 1)
|
|
76
|
+
renderer.clear()
|
|
77
|
+
renderer.render(viewScene, viewCamera)
|
|
78
|
+
renderer.setRenderTarget(null)
|
|
79
|
+
viewScene.overrideMaterial = null
|
|
80
|
+
const pixels = new Uint8Array(w * h * 4)
|
|
81
|
+
renderer.readRenderTargetPixels(target, 0, 0, w, h, pixels)
|
|
82
|
+
let lit = 0
|
|
83
|
+
for (let i = 0; i < pixels.length; i += 4) if (pixels[i] > 127) lit++
|
|
84
|
+
const share = lit / (w * h) // OC hip: pistol ~0.06, SMG ~0.08, rifle ~0.09
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
The same mask with a central 20% x 20% box gives the aimed-view occlusion share (OC's
|
|
88
|
+
glove case went from 35.29% to 0.04%).
|
|
89
|
+
|
|
90
|
+
## Aim and sights
|
|
91
|
+
|
|
92
|
+
- Compute the aimed offset from the sight mesh, not a socket: take
|
|
93
|
+
`sight.getWorldPosition(v)`, bring it into the view camera's space, and move the gun so
|
|
94
|
+
that point lands on the camera's axis. OC's socket was 343 mm off the ring, 31 px.
|
|
95
|
+
- Build the gun's aim from yaw and pitch (an `Euler` in `'YXZ'` order) or `lookAt` with a
|
|
96
|
+
fixed up vector. `Quaternion.setFromUnitVectors` takes the shortest arc and added 25 to
|
|
97
|
+
30 degrees of roll.
|
|
98
|
+
- Ray-test each optic in CI: cast rays from the eye point through the lens area with a
|
|
99
|
+
`Raycaster` against the gun's own meshes; any hit on a "transparent" lens is a defect
|
|
100
|
+
(4 OC rifles blocked 385 of 385 rays).
|
|
101
|
+
- Draw the reticle in a fragment shader on the lens, visible only from the eye side,
|
|
102
|
+
over dark tinted glass with a fresnel edge. Exclude housings from camo materials.
|
|
103
|
+
- Scope tubes need 48 or more radial segments to read round when aimed.
|
|
104
|
+
|
|
105
|
+
## Load hero models before they can be equipped
|
|
106
|
+
|
|
107
|
+
A gun is equippable only after its full model has loaded and its shaders have compiled.
|
|
108
|
+
Until then the previous gun stays in hand, and a purchase is refused with a message.
|
|
109
|
+
|
|
110
|
+
```js
|
|
111
|
+
const cache = new Map() // url -> Promise<THREE.Object3D>
|
|
112
|
+
function loadGun(url) {
|
|
113
|
+
if (!cache.has(url)) cache.set(url, (async () => {
|
|
114
|
+
const gltf = await gltfLoader.loadAsync(url)
|
|
115
|
+
const gun = gltf.scene
|
|
116
|
+
gun.traverse(o => { if (o.isMesh) o.material = o.material.clone() })
|
|
117
|
+
await renderer.compileAsync(gun, viewCamera, viewScene)
|
|
118
|
+
return gun
|
|
119
|
+
})())
|
|
120
|
+
return cache.get(url)
|
|
121
|
+
}
|
|
122
|
+
|
|
123
|
+
async function equip(url) {
|
|
124
|
+
const next = await loadGun(url) // the old gun stays in hand while this resolves
|
|
125
|
+
holster(current)
|
|
126
|
+
draw(next)
|
|
127
|
+
current = next
|
|
128
|
+
}
|
|
129
|
+
```
|
|
130
|
+
|
|
131
|
+
- Preload the guns the player can reach next: the loadout, the box pool, wall buys near
|
|
132
|
+
the player, menu neighbours. OC prewarmed its visible roster of 8 guns, about 28 MB.
|
|
133
|
+
- Gate the buy prompt on `cache.get(url)` having resolved, so a wall gun never charges
|
|
134
|
+
points for a model that is not there.
|
|
135
|
+
- Use KTX2 textures (`KTX2Loader`) and meshopt geometry (`MeshoptDecoder`) for hero guns,
|
|
136
|
+
and upload textures early with `renderer.initTexture(texture)` so the first draw does
|
|
137
|
+
not hitch.
|
|
138
|
+
- Never load a low level of detail as a placeholder. If nothing is resident, show a UI
|
|
139
|
+
loading state.
|
|
140
|
+
|
|
141
|
+
## Reload beats in one table
|
|
142
|
+
|
|
143
|
+
```js
|
|
144
|
+
// Exported from the beat spec; animation and audio both read it.
|
|
145
|
+
const reloadRay = [
|
|
146
|
+
{ t: 0.00, beat: 'latch', sound: 'ray_latch' },
|
|
147
|
+
{ t: 0.28, beat: 'chamber_open', sound: 'ray_open' },
|
|
148
|
+
{ t: 0.62, beat: 'cells_out', sound: 'ray_cells_out' },
|
|
149
|
+
// one row per fresh cell in, then snap shut and flicker on
|
|
150
|
+
]
|
|
151
|
+
```
|
|
152
|
+
|
|
153
|
+
Drive an `AnimationAction` and schedule each sound from the same row, with
|
|
154
|
+
`AudioContext.currentTime` plus the row's offset from the action's start. The times
|
|
155
|
+
above are an illustration of the format, not OC's values.
|
|
156
|
+
|
|
157
|
+
## Hand contact check
|
|
158
|
+
|
|
159
|
+
Offline, for each gun and reload phase, pose the arms with `AnimationMixer.setTime`,
|
|
160
|
+
read each hand vertex with `SkinnedMesh.getVertexPosition(i, v)` and transform it to
|
|
161
|
+
world space, then measure how far it sits inside the gun's mesh (a signed distance from
|
|
162
|
+
a BVH such as `three-mesh-bvh`). Flag every phase deeper than 8 mm.
|
|
163
|
+
|
|
164
|
+
LC's finger solver passes at 1.5 mm and counts every vertex; every second vertex missed a
|
|
165
|
+
thumb 1.7 mm into a hammer. Measure on the game's own skinned mesh, not the solver's
|
|
166
|
+
copy of the rig. The method is in [reloads-and-hands.md](reloads-and-hands.md).
|
|
167
|
+
|
|
168
|
+
## Lens floor test
|
|
169
|
+
|
|
170
|
+
Run it headless on the real view code, every frame of a stepped run through every state
|
|
171
|
+
and every change between two. Floors and shares are LC's.
|
|
172
|
+
|
|
173
|
+
```js
|
|
174
|
+
const v = new THREE.Vector3(), eye = new THREE.Vector3()
|
|
175
|
+
function lensFrame(parts, camera, gridW = 120, gridH = 58) {
|
|
176
|
+
camera.getWorldPosition(eye)
|
|
177
|
+
const near = new Uint8Array(gridW * gridH) // cells covered by something under its floor
|
|
178
|
+
let closest = Infinity
|
|
179
|
+
for (const { mesh, floor } of parts) { // floor: weapon 0.12, glove and sleeve 0.09
|
|
180
|
+
const pos = mesh.geometry.attributes.position
|
|
181
|
+
for (let i = 0; i < pos.count; i++) {
|
|
182
|
+
if (mesh.isSkinnedMesh) mesh.getVertexPosition(i, v); else v.fromBufferAttribute(pos, i)
|
|
183
|
+
v.applyMatrix4(mesh.matrixWorld)
|
|
184
|
+
const d = v.distanceTo(eye)
|
|
185
|
+
closest = Math.min(closest, d - floor)
|
|
186
|
+
v.project(camera) // to normalised device coordinates
|
|
187
|
+
if (d >= floor || Math.abs(v.x) > 1 || Math.abs(v.y) > 1 || Math.abs(v.z) > 1) continue // off screen or behind the lens
|
|
188
|
+
const gx = Math.floor((v.x + 1) / 2 * gridW), gy = Math.floor((1 - v.y) / 2 * gridH)
|
|
189
|
+
near[Math.min(gy, gridH - 1) * gridW + Math.min(gx, gridW - 1)] = 1
|
|
190
|
+
}
|
|
191
|
+
}
|
|
192
|
+
const cover = near.reduce((a, b) => a + b, 0) / near.length
|
|
193
|
+
return { closest, cover } // LC fails cover over 1/6 for more than three frames
|
|
194
|
+
}
|
|
195
|
+
```
|
|
196
|
+
|
|
197
|
+
While aimed, skip the sight's own parts: the weapon's eye relief (6 to 15 cm for LC's
|
|
198
|
+
apertures) places them, and the floors govern everything else.
|
|
199
|
+
|
|
200
|
+
Vertices undersample large triangles, so subdivide the grid test or rasterise a mask
|
|
201
|
+
(the coverage mask above) when a part has few vertices. Run it with the camera aspect set
|
|
202
|
+
to the widest window the players use: a hold tuned at 16:9 lost its hands off the bottom
|
|
203
|
+
of a wider window.
|
|
204
|
+
|
|
205
|
+
## Camera-attached objects in the same frame
|
|
206
|
+
|
|
207
|
+
Update the camera first, then pose the view model and everything attached to the camera
|
|
208
|
+
from its new matrix, then render. A scope canopy or a held device posed before the
|
|
209
|
+
camera moved draws a frame late and slides under fast mouse look (OS: 31 cm and 150 to
|
|
210
|
+
480 mm, both to 0).
|
|
211
|
+
|
|
212
|
+
```js
|
|
213
|
+
updateLook(input) // camera rotation from this frame's input
|
|
214
|
+
camera.updateMatrixWorld()
|
|
215
|
+
poseViewModel(camera.matrixWorld) // gun, hands, scope canopy, held screens
|
|
216
|
+
renderFrame()
|
|
217
|
+
```
|
|
218
|
+
|
|
219
|
+
With temporal anti-aliasing or motion blur on WebGPU (three.js `TRAANode` reading a
|
|
220
|
+
velocity output, in recent releases; check the names in yours), give the view model a
|
|
221
|
+
velocity from the view camera's own current and previous matrices. Writing zero at hip
|
|
222
|
+
let the resolve smear world pixels at the gun's silhouette into a dotted halo (OS); zero
|
|
223
|
+
is right only inside an aimed see-through optic. Keep the view model out of motion blur.
|
|
224
|
+
|
|
225
|
+
## Empty magazines as a draw range
|
|
226
|
+
|
|
227
|
+
Order a magazine's index buffer with the rounds last, one block per round, and draw fewer
|
|
228
|
+
rounds as it empties. One carried part then leaves empty and arrives full, with no swap.
|
|
229
|
+
|
|
230
|
+
```js
|
|
231
|
+
const body = mag.userData.bodyIndexCount, perRound = mag.userData.indicesPerRound
|
|
232
|
+
mag.geometry.setDrawRange(0, body + roundsLeft * perRound)
|
|
233
|
+
```
|
|
234
|
+
|
|
235
|
+
## Other engines
|
|
236
|
+
|
|
237
|
+
- Unity (URP): a base camera for the world and an overlay camera in its camera stack for
|
|
238
|
+
a weapon layer, with the overlay set to clear depth.
|
|
239
|
+
- Godot: render the weapon in a `SubViewport` with its own `Camera3D` and composite it
|
|
240
|
+
over the main view, or give the weapon its own visual layer and a second camera.
|