@opengamehq/cli 0.9.8 → 0.10.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.
Files changed (350) hide show
  1. package/AGENTS.md +44 -17
  2. package/CHANGELOG.md +29 -0
  3. package/README.md +8 -6
  4. package/dist/cli.mjs +146 -145
  5. package/dist/opengame-global.js +3 -3
  6. package/dist/preflight-worker.mjs +10 -10
  7. package/dist/runtime-builder.mjs +1 -1
  8. package/dist/skills/manifest.json +1407 -143
  9. package/dist/skills/opengame-accessibility/SKILL.md +48 -32
  10. package/dist/skills/opengame-all-in-one/SKILL.md +195 -0
  11. package/dist/skills/opengame-all-in-one/references/opengame-accessibility/README.md +102 -0
  12. package/dist/skills/opengame-all-in-one/references/opengame-api/README.md +108 -0
  13. package/dist/skills/opengame-all-in-one/references/opengame-assets/README.md +168 -0
  14. package/dist/skills/opengame-all-in-one/references/opengame-assets/references/pipeline.md +164 -0
  15. package/dist/skills/opengame-all-in-one/references/opengame-audio/README.md +238 -0
  16. package/dist/skills/opengame-all-in-one/references/opengame-audio/helpers/audio-chain.js +325 -0
  17. package/dist/skills/opengame-all-in-one/references/opengame-audio/references/mix-notes.md +125 -0
  18. package/dist/skills/opengame-all-in-one/references/opengame-audio/references/qa-without-ears.md +177 -0
  19. package/dist/skills/opengame-all-in-one/references/opengame-capture/README.md +128 -0
  20. package/dist/skills/opengame-all-in-one/references/opengame-capture/references/pipeline.md +114 -0
  21. package/dist/skills/opengame-all-in-one/references/opengame-capture/references/threejs.md +161 -0
  22. package/dist/skills/opengame-all-in-one/references/opengame-characters/README.md +180 -0
  23. package/dist/skills/opengame-all-in-one/references/opengame-characters/references/first-person-body.md +108 -0
  24. package/dist/skills/opengame-all-in-one/references/opengame-characters/references/integration.md +144 -0
  25. package/dist/skills/opengame-all-in-one/references/opengame-characters/references/player-og.md +160 -0
  26. package/dist/skills/opengame-all-in-one/references/opengame-cli/README.md +190 -0
  27. package/dist/skills/opengame-all-in-one/references/opengame-deploy/README.md +229 -0
  28. package/dist/skills/opengame-all-in-one/references/opengame-deploy/references/json-events.md +63 -0
  29. package/dist/skills/opengame-all-in-one/references/opengame-deploy/references/manifest.md +90 -0
  30. package/dist/skills/opengame-all-in-one/references/opengame-deploy/references/packaging.md +120 -0
  31. package/dist/skills/opengame-all-in-one/references/opengame-depth/README.md +154 -0
  32. package/dist/skills/opengame-all-in-one/references/opengame-enemies/README.md +155 -0
  33. package/dist/skills/opengame-all-in-one/references/opengame-enemies/references/pacing-and-bots.md +108 -0
  34. package/dist/skills/opengame-all-in-one/references/opengame-enemies/references/threejs.md +193 -0
  35. package/dist/skills/opengame-all-in-one/references/opengame-front-end/README.md +185 -0
  36. package/dist/skills/opengame-all-in-one/references/opengame-front-end/references/launch.md +50 -0
  37. package/dist/skills/opengame-all-in-one/references/opengame-front-end/references/menus.md +81 -0
  38. package/dist/skills/opengame-all-in-one/references/opengame-game-feel/README.md +181 -0
  39. package/dist/skills/opengame-all-in-one/references/opengame-game-feel/helpers/spring.js +146 -0
  40. package/dist/skills/opengame-all-in-one/references/opengame-game-feel/references/feel-numbers.md +142 -0
  41. package/dist/skills/opengame-all-in-one/references/opengame-game-feel/references/killcam.md +88 -0
  42. package/dist/skills/opengame-all-in-one/references/opengame-jam/README.md +121 -0
  43. package/dist/skills/opengame-all-in-one/references/opengame-lighting/README.md +141 -0
  44. package/dist/skills/opengame-all-in-one/references/opengame-lighting/helpers/light-pool.js +185 -0
  45. package/dist/skills/opengame-all-in-one/references/opengame-loading/README.md +135 -0
  46. package/dist/skills/opengame-all-in-one/references/opengame-loading/helpers/loading-count.mjs +115 -0
  47. package/dist/skills/opengame-all-in-one/references/opengame-loading/references/threejs.md +141 -0
  48. package/dist/skills/opengame-all-in-one/references/opengame-look/README.md +181 -0
  49. package/dist/skills/opengame-all-in-one/references/opengame-look/references/matching-a-reference.md +73 -0
  50. package/dist/skills/opengame-all-in-one/references/opengame-look/references/painterly.md +69 -0
  51. package/dist/skills/opengame-all-in-one/references/opengame-look/references/post-and-lens.md +73 -0
  52. package/dist/skills/opengame-all-in-one/references/opengame-maps/README.md +74 -0
  53. package/dist/skills/opengame-all-in-one/references/opengame-maps/references/map-spec.md +77 -0
  54. package/dist/skills/opengame-all-in-one/references/opengame-mobile/README.md +86 -0
  55. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/README.md +183 -0
  56. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/briefs.md +293 -0
  57. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/day-one-questions.md +46 -0
  58. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/edge-cases.md +27 -0
  59. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/filmable.md +244 -0
  60. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/finishing.md +126 -0
  61. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/measure.md +282 -0
  62. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-capture.md +151 -0
  63. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-gates.md +84 -0
  64. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-genres.md +198 -0
  65. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-grammar.md +320 -0
  66. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-ops.md +127 -0
  67. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/og-snipers-record.md +110 -0
  68. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/owner-eye.md +214 -0
  69. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/reference-study.md +293 -0
  70. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/song.md +64 -0
  71. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/README.md +193 -0
  72. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/briefs.md +293 -0
  73. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/day-one-questions.md +46 -0
  74. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/filmable.md +244 -0
  75. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/measure.md +282 -0
  76. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-capture.md +151 -0
  77. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-gates.md +84 -0
  78. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-genres.md +198 -0
  79. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-grammar.md +320 -0
  80. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-ops.md +127 -0
  81. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/og-snipers-record.md +110 -0
  82. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/owner-eye.md +214 -0
  83. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/reference-study.md +293 -0
  84. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/song.md +64 -0
  85. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/README.md +174 -0
  86. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/briefs.md +293 -0
  87. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/day-one-questions.md +46 -0
  88. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/filmable.md +244 -0
  89. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/finishing.md +126 -0
  90. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/measure.md +282 -0
  91. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-capture.md +151 -0
  92. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-gates.md +84 -0
  93. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-genres.md +198 -0
  94. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-grammar.md +320 -0
  95. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-ops.md +127 -0
  96. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/og-snipers-record.md +110 -0
  97. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/owner-eye.md +214 -0
  98. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/reference-study.md +293 -0
  99. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/song.md +64 -0
  100. package/dist/skills/opengame-all-in-one/references/opengame-multiplayer/README.md +139 -0
  101. package/dist/skills/opengame-all-in-one/references/opengame-multiplayer/references/bot-lobbies.md +71 -0
  102. package/dist/skills/opengame-all-in-one/references/opengame-multiplayer/references/netcode.md +165 -0
  103. package/dist/skills/opengame-all-in-one/references/opengame-performance/README.md +177 -0
  104. package/dist/skills/opengame-all-in-one/references/opengame-performance/helpers/landing-pacer.mjs +86 -0
  105. package/dist/skills/opengame-all-in-one/references/opengame-performance/references/measuring.md +123 -0
  106. package/dist/skills/opengame-all-in-one/references/opengame-performance/references/webgpu.md +86 -0
  107. package/dist/skills/opengame-all-in-one/references/opengame-production/README.md +192 -0
  108. package/dist/skills/opengame-all-in-one/references/opengame-production/references/team.md +107 -0
  109. package/dist/skills/opengame-all-in-one/references/opengame-production/references/templates.md +153 -0
  110. package/dist/skills/opengame-all-in-one/references/opengame-quality-bar/README.md +170 -0
  111. package/dist/skills/opengame-all-in-one/references/opengame-quality-bar/references/cheap-tells.md +43 -0
  112. package/dist/skills/opengame-all-in-one/references/opengame-quality-bar/references/judges.md +95 -0
  113. package/dist/skills/opengame-all-in-one/references/opengame-quality-bar/references/review-prompt.md +32 -0
  114. package/dist/skills/opengame-all-in-one/references/opengame-rhythm/README.md +134 -0
  115. package/dist/skills/opengame-all-in-one/references/opengame-rhythm/references/charting.md +109 -0
  116. package/dist/skills/opengame-all-in-one/references/opengame-rhythm/references/timing.md +92 -0
  117. package/dist/skills/opengame-all-in-one/references/opengame-router/README.md +54 -0
  118. package/dist/skills/opengame-all-in-one/references/opengame-router/references/process.md +38 -0
  119. package/dist/skills/opengame-all-in-one/references/opengame-scene-audit/README.md +136 -0
  120. package/dist/skills/opengame-all-in-one/references/opengame-scene-audit/helpers/scene-audit.js +677 -0
  121. package/dist/skills/opengame-all-in-one/references/opengame-sdk/README.md +283 -0
  122. package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/engines.md +93 -0
  123. package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/frame.md +107 -0
  124. package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/identity.md +111 -0
  125. package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/leaderboards.md +115 -0
  126. package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/radio.md +71 -0
  127. package/dist/skills/opengame-all-in-one/references/opengame-stability/README.md +112 -0
  128. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/README.md +160 -0
  129. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/archetypes.md +113 -0
  130. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/briefs.md +273 -0
  131. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/core.md +129 -0
  132. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/craft.md +299 -0
  133. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/edge-cases.md +27 -0
  134. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/filmable.md +244 -0
  135. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/finishing.md +126 -0
  136. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/gates.md +184 -0
  137. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/measure.md +282 -0
  138. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/music.md +148 -0
  139. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/og-clash-record.md +133 -0
  140. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/ops.md +154 -0
  141. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/owner-eye.md +214 -0
  142. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/review.md +141 -0
  143. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/title.md +92 -0
  144. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/README.md +172 -0
  145. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/archetypes.md +113 -0
  146. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/briefs.md +273 -0
  147. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/core.md +129 -0
  148. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/craft.md +299 -0
  149. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/edge-cases.md +27 -0
  150. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/filmable.md +244 -0
  151. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/finishing.md +126 -0
  152. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/gates.md +184 -0
  153. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/measure.md +282 -0
  154. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/music.md +148 -0
  155. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/og-clash-record.md +133 -0
  156. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/ops.md +154 -0
  157. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/owner-eye.md +214 -0
  158. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/reference-set.md +92 -0
  159. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/review.md +141 -0
  160. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/title.md +92 -0
  161. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/README.md +141 -0
  162. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/archetypes.md +113 -0
  163. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/briefs.md +273 -0
  164. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/core.md +129 -0
  165. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/craft.md +299 -0
  166. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/edge-cases.md +27 -0
  167. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/filmable.md +244 -0
  168. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/finishing.md +126 -0
  169. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/gates.md +184 -0
  170. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/measure.md +282 -0
  171. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/music.md +148 -0
  172. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/og-clash-record.md +133 -0
  173. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/ops.md +154 -0
  174. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/owner-eye.md +214 -0
  175. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/review.md +141 -0
  176. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/title.md +92 -0
  177. package/dist/skills/opengame-all-in-one/references/opengame-verification/README.md +197 -0
  178. package/dist/skills/opengame-all-in-one/references/opengame-verification/helpers/browser-evidence.mjs +74 -0
  179. package/dist/skills/opengame-all-in-one/references/opengame-weapons/README.md +179 -0
  180. package/dist/skills/opengame-all-in-one/references/opengame-weapons/references/handling-numbers.md +114 -0
  181. package/dist/skills/opengame-all-in-one/references/opengame-weapons/references/reloads-and-hands.md +96 -0
  182. package/dist/skills/opengame-all-in-one/references/opengame-weapons/references/sights-and-scopes.md +98 -0
  183. package/dist/skills/opengame-all-in-one/references/opengame-weapons/references/threejs.md +240 -0
  184. package/dist/skills/opengame-all-in-one/references/opengame-world-physics/README.md +141 -0
  185. package/dist/skills/opengame-all-in-one/references/opengame-world-physics/references/measured-failures.md +79 -0
  186. package/dist/skills/opengame-api/SKILL.md +33 -6
  187. package/dist/skills/opengame-assets/SKILL.md +79 -31
  188. package/dist/skills/opengame-assets/references/pipeline.md +67 -0
  189. package/dist/skills/opengame-audio/SKILL.md +129 -41
  190. package/dist/skills/opengame-audio/references/mix-notes.md +44 -1
  191. package/dist/skills/opengame-audio/references/qa-without-ears.md +177 -0
  192. package/dist/skills/opengame-capture/SKILL.md +44 -20
  193. package/dist/skills/opengame-capture/references/pipeline.md +33 -1
  194. package/dist/skills/opengame-capture/references/threejs.md +17 -1
  195. package/dist/skills/opengame-characters/SKILL.md +94 -39
  196. package/dist/skills/opengame-characters/references/first-person-body.md +108 -0
  197. package/dist/skills/opengame-characters/references/player-og.md +1 -1
  198. package/dist/skills/opengame-cli/SKILL.md +6 -5
  199. package/dist/skills/opengame-deploy/SKILL.md +41 -15
  200. package/dist/skills/opengame-deploy/references/json-events.md +6 -5
  201. package/dist/skills/opengame-deploy/references/manifest.md +3 -2
  202. package/dist/skills/opengame-deploy/references/packaging.md +29 -26
  203. package/dist/skills/opengame-depth/SKILL.md +61 -33
  204. package/dist/skills/opengame-enemies/SKILL.md +96 -40
  205. package/dist/skills/opengame-enemies/references/pacing-and-bots.md +108 -0
  206. package/dist/skills/opengame-enemies/references/threejs.md +59 -0
  207. package/dist/skills/opengame-front-end/SKILL.md +85 -39
  208. package/dist/skills/opengame-front-end/references/menus.md +42 -8
  209. package/dist/skills/opengame-game-feel/SKILL.md +95 -47
  210. package/dist/skills/opengame-game-feel/references/feel-numbers.md +59 -0
  211. package/dist/skills/opengame-game-feel/references/killcam.md +88 -0
  212. package/dist/skills/opengame-jam/SKILL.md +55 -33
  213. package/dist/skills/opengame-lighting/SKILL.md +85 -34
  214. package/dist/skills/opengame-loading/SKILL.md +78 -38
  215. package/dist/skills/opengame-loading/helpers/loading-count.mjs +115 -0
  216. package/dist/skills/opengame-loading/references/threejs.md +32 -7
  217. package/dist/skills/opengame-look/SKILL.md +122 -51
  218. package/dist/skills/opengame-look/references/matching-a-reference.md +73 -0
  219. package/dist/skills/opengame-look/references/painterly.md +69 -0
  220. package/dist/skills/opengame-look/references/post-and-lens.md +10 -3
  221. package/dist/skills/opengame-maps/SKILL.md +78 -0
  222. package/dist/skills/opengame-maps/references/map-spec.md +77 -0
  223. package/dist/skills/opengame-mobile/SKILL.md +18 -18
  224. package/dist/skills/opengame-montage-make/SKILL.md +187 -0
  225. package/dist/skills/opengame-montage-make/references/briefs.md +293 -0
  226. package/dist/skills/opengame-montage-make/references/day-one-questions.md +46 -0
  227. package/dist/skills/opengame-montage-make/references/edge-cases.md +27 -0
  228. package/dist/skills/opengame-montage-make/references/filmable.md +244 -0
  229. package/dist/skills/opengame-montage-make/references/finishing.md +126 -0
  230. package/dist/skills/opengame-montage-make/references/measure.md +282 -0
  231. package/dist/skills/opengame-montage-make/references/montage-capture.md +151 -0
  232. package/dist/skills/opengame-montage-make/references/montage-gates.md +84 -0
  233. package/dist/skills/opengame-montage-make/references/montage-genres.md +198 -0
  234. package/dist/skills/opengame-montage-make/references/montage-grammar.md +320 -0
  235. package/dist/skills/opengame-montage-make/references/montage-ops.md +127 -0
  236. package/dist/skills/opengame-montage-make/references/og-snipers-record.md +110 -0
  237. package/dist/skills/opengame-montage-make/references/owner-eye.md +214 -0
  238. package/dist/skills/opengame-montage-make/references/reference-study.md +293 -0
  239. package/dist/skills/opengame-montage-make/references/song.md +64 -0
  240. package/dist/skills/opengame-montage-plan/SKILL.md +197 -0
  241. package/dist/skills/opengame-montage-plan/references/briefs.md +293 -0
  242. package/dist/skills/opengame-montage-plan/references/day-one-questions.md +46 -0
  243. package/dist/skills/opengame-montage-plan/references/filmable.md +244 -0
  244. package/dist/skills/opengame-montage-plan/references/measure.md +282 -0
  245. package/dist/skills/opengame-montage-plan/references/montage-capture.md +151 -0
  246. package/dist/skills/opengame-montage-plan/references/montage-gates.md +84 -0
  247. package/dist/skills/opengame-montage-plan/references/montage-genres.md +198 -0
  248. package/dist/skills/opengame-montage-plan/references/montage-grammar.md +320 -0
  249. package/dist/skills/opengame-montage-plan/references/montage-ops.md +127 -0
  250. package/dist/skills/opengame-montage-plan/references/og-snipers-record.md +110 -0
  251. package/dist/skills/opengame-montage-plan/references/owner-eye.md +214 -0
  252. package/dist/skills/opengame-montage-plan/references/reference-study.md +293 -0
  253. package/dist/skills/opengame-montage-plan/references/song.md +64 -0
  254. package/dist/skills/opengame-montage-review-and-improve/SKILL.md +178 -0
  255. package/dist/skills/opengame-montage-review-and-improve/references/briefs.md +293 -0
  256. package/dist/skills/opengame-montage-review-and-improve/references/day-one-questions.md +46 -0
  257. package/dist/skills/opengame-montage-review-and-improve/references/filmable.md +244 -0
  258. package/dist/skills/opengame-montage-review-and-improve/references/finishing.md +126 -0
  259. package/dist/skills/opengame-montage-review-and-improve/references/measure.md +282 -0
  260. package/dist/skills/opengame-montage-review-and-improve/references/montage-capture.md +151 -0
  261. package/dist/skills/opengame-montage-review-and-improve/references/montage-gates.md +84 -0
  262. package/dist/skills/opengame-montage-review-and-improve/references/montage-genres.md +198 -0
  263. package/dist/skills/opengame-montage-review-and-improve/references/montage-grammar.md +320 -0
  264. package/dist/skills/opengame-montage-review-and-improve/references/montage-ops.md +127 -0
  265. package/dist/skills/opengame-montage-review-and-improve/references/og-snipers-record.md +110 -0
  266. package/dist/skills/opengame-montage-review-and-improve/references/owner-eye.md +214 -0
  267. package/dist/skills/opengame-montage-review-and-improve/references/reference-study.md +293 -0
  268. package/dist/skills/opengame-montage-review-and-improve/references/song.md +64 -0
  269. package/dist/skills/opengame-multiplayer/SKILL.md +143 -0
  270. package/dist/skills/opengame-multiplayer/references/bot-lobbies.md +71 -0
  271. package/dist/skills/opengame-multiplayer/references/netcode.md +165 -0
  272. package/dist/skills/opengame-performance/SKILL.md +106 -65
  273. package/dist/skills/opengame-performance/helpers/landing-pacer.mjs +86 -0
  274. package/dist/skills/opengame-performance/references/measuring.md +51 -0
  275. package/dist/skills/opengame-performance/references/webgpu.md +86 -0
  276. package/dist/skills/opengame-production/SKILL.md +119 -54
  277. package/dist/skills/opengame-production/references/team.md +107 -0
  278. package/dist/skills/opengame-production/references/templates.md +106 -16
  279. package/dist/skills/opengame-quality-bar/SKILL.md +94 -42
  280. package/dist/skills/opengame-quality-bar/references/cheap-tells.md +14 -7
  281. package/dist/skills/opengame-quality-bar/references/judges.md +95 -0
  282. package/dist/skills/opengame-quality-bar/references/review-prompt.md +10 -5
  283. package/dist/skills/opengame-rhythm/SKILL.md +138 -0
  284. package/dist/skills/opengame-rhythm/references/charting.md +109 -0
  285. package/dist/skills/opengame-rhythm/references/timing.md +92 -0
  286. package/dist/skills/opengame-router/SKILL.md +10 -2
  287. package/dist/skills/opengame-scene-audit/SKILL.md +64 -47
  288. package/dist/skills/opengame-scene-audit/helpers/scene-audit.js +97 -19
  289. package/dist/skills/opengame-sdk/SKILL.md +26 -9
  290. package/dist/skills/opengame-sdk/references/engines.md +2 -2
  291. package/dist/skills/opengame-sdk/references/identity.md +10 -11
  292. package/dist/skills/opengame-stability/SKILL.md +59 -27
  293. package/dist/skills/opengame-trailer-make/SKILL.md +164 -0
  294. package/dist/skills/opengame-trailer-make/references/archetypes.md +113 -0
  295. package/dist/skills/opengame-trailer-make/references/briefs.md +273 -0
  296. package/dist/skills/opengame-trailer-make/references/core.md +129 -0
  297. package/dist/skills/opengame-trailer-make/references/craft.md +299 -0
  298. package/dist/skills/opengame-trailer-make/references/edge-cases.md +27 -0
  299. package/dist/skills/opengame-trailer-make/references/filmable.md +244 -0
  300. package/dist/skills/opengame-trailer-make/references/finishing.md +126 -0
  301. package/dist/skills/opengame-trailer-make/references/gates.md +184 -0
  302. package/dist/skills/opengame-trailer-make/references/measure.md +282 -0
  303. package/dist/skills/opengame-trailer-make/references/music.md +148 -0
  304. package/dist/skills/opengame-trailer-make/references/og-clash-record.md +133 -0
  305. package/dist/skills/opengame-trailer-make/references/ops.md +154 -0
  306. package/dist/skills/opengame-trailer-make/references/owner-eye.md +214 -0
  307. package/dist/skills/opengame-trailer-make/references/review.md +141 -0
  308. package/dist/skills/opengame-trailer-make/references/title.md +92 -0
  309. package/dist/skills/opengame-trailer-plan/SKILL.md +176 -0
  310. package/dist/skills/opengame-trailer-plan/references/archetypes.md +113 -0
  311. package/dist/skills/opengame-trailer-plan/references/briefs.md +273 -0
  312. package/dist/skills/opengame-trailer-plan/references/core.md +129 -0
  313. package/dist/skills/opengame-trailer-plan/references/craft.md +299 -0
  314. package/dist/skills/opengame-trailer-plan/references/edge-cases.md +27 -0
  315. package/dist/skills/opengame-trailer-plan/references/filmable.md +244 -0
  316. package/dist/skills/opengame-trailer-plan/references/finishing.md +126 -0
  317. package/dist/skills/opengame-trailer-plan/references/gates.md +184 -0
  318. package/dist/skills/opengame-trailer-plan/references/measure.md +282 -0
  319. package/dist/skills/opengame-trailer-plan/references/music.md +148 -0
  320. package/dist/skills/opengame-trailer-plan/references/og-clash-record.md +133 -0
  321. package/dist/skills/opengame-trailer-plan/references/ops.md +154 -0
  322. package/dist/skills/opengame-trailer-plan/references/owner-eye.md +214 -0
  323. package/dist/skills/opengame-trailer-plan/references/reference-set.md +92 -0
  324. package/dist/skills/opengame-trailer-plan/references/review.md +141 -0
  325. package/dist/skills/opengame-trailer-plan/references/title.md +92 -0
  326. package/dist/skills/opengame-trailer-review-and-improve/SKILL.md +145 -0
  327. package/dist/skills/opengame-trailer-review-and-improve/references/archetypes.md +113 -0
  328. package/dist/skills/opengame-trailer-review-and-improve/references/briefs.md +273 -0
  329. package/dist/skills/opengame-trailer-review-and-improve/references/core.md +129 -0
  330. package/dist/skills/opengame-trailer-review-and-improve/references/craft.md +299 -0
  331. package/dist/skills/opengame-trailer-review-and-improve/references/edge-cases.md +27 -0
  332. package/dist/skills/opengame-trailer-review-and-improve/references/filmable.md +244 -0
  333. package/dist/skills/opengame-trailer-review-and-improve/references/finishing.md +126 -0
  334. package/dist/skills/opengame-trailer-review-and-improve/references/gates.md +184 -0
  335. package/dist/skills/opengame-trailer-review-and-improve/references/measure.md +282 -0
  336. package/dist/skills/opengame-trailer-review-and-improve/references/music.md +148 -0
  337. package/dist/skills/opengame-trailer-review-and-improve/references/og-clash-record.md +133 -0
  338. package/dist/skills/opengame-trailer-review-and-improve/references/ops.md +154 -0
  339. package/dist/skills/opengame-trailer-review-and-improve/references/owner-eye.md +214 -0
  340. package/dist/skills/opengame-trailer-review-and-improve/references/review.md +141 -0
  341. package/dist/skills/opengame-trailer-review-and-improve/references/title.md +92 -0
  342. package/dist/skills/opengame-verification/SKILL.md +113 -48
  343. package/dist/skills/opengame-weapons/SKILL.md +129 -55
  344. package/dist/skills/opengame-weapons/references/handling-numbers.md +42 -0
  345. package/dist/skills/opengame-weapons/references/reloads-and-hands.md +96 -0
  346. package/dist/skills/opengame-weapons/references/sights-and-scopes.md +98 -0
  347. package/dist/skills/opengame-weapons/references/threejs.md +71 -0
  348. package/dist/skills/opengame-world-physics/SKILL.md +55 -24
  349. package/dist/skills/opengame-world-physics/references/measured-failures.md +28 -1
  350. package/package.json +1 -1
@@ -161,6 +161,77 @@ read each hand vertex with `SkinnedMesh.getVertexPosition(i, v)` and transform i
161
161
  world space, then measure how far it sits inside the gun's mesh (a signed distance from
162
162
  a BVH such as `three-mesh-bvh`). Flag every phase deeper than 8 mm.
163
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
+
164
235
  ## Other engines
165
236
 
166
237
  - Unity (URP): a base camera for the world and an overlay camera in its camera stack for
@@ -1,16 +1,18 @@
1
1
  ---
2
2
  name: opengame-world-physics
3
- description: Make a 3D browser game's world physically coherent for players and AI. Covers colliders that fit what is drawn, stairs walked without jumping, a navigation step that matches the body's step, no tunnelling, bounded depenetration, ragdolls that settle, corpses on deadlines, ray queries on a budget and a fixed step. Use when the person says I walked through a wall, fell through the floor, have to jump up stairs, zombies get stuck on steps, corpses spaz out, or movement feels floaty.
3
+ description: Make a 3D browser game's world physically coherent. Covers collision that equals the picture both ways, separate body and shot shapes, pipelines that fail closed, art passes that leave gameplay alone, openings sized to the largest body, step heights, the navigation step, tunnelling, depenetration, ragdolls, corpses and ray budgets. Use when the person says invisible walls, I walked through a wall, fell through the floor, cant get through a door, zombies get stuck, or corpses spaz out.
4
4
  metadata:
5
- version: "1.0.0"
5
+ version: "1.1.0"
6
6
  ---
7
7
 
8
8
  # World physics for a walking player
9
9
 
10
- What players report as "the physics is broken" is almost always one of a few seams:
11
- something drawn that the collision layer does not know about, a staircase whose
12
- collision is a wall of risers, a fast body that skips a thin floor in one frame, or a
13
- correction that teleports a body out of a corner. Each has a known fix.
10
+ What players report as "the physics is broken" is almost always one of a few mismatches:
11
+ something drawn that the collision layer does not know about, collision where nothing is
12
+ drawn, a staircase whose collision is a wall of risers, a fast body that skips a thin
13
+ floor in one frame, or a correction that teleports a body out of a corner. Each has a
14
+ known fix. The second, the invisible wall, was among the complaints our shooters' owners
15
+ repeated most, and the one the first version of these skills did not name.
14
16
 
15
17
  Rules carry five tags; `opengame-quality-bar` explains them and the game codes. The
16
18
  numbers below are at human scale in metres; scale them with the game.
@@ -19,36 +21,64 @@ numbers below are at human scale in metres; scale them with the game.
19
21
 
20
22
  ### One placement, two layers
21
23
  - **Invariant:** What is drawn and what collides come from the same placements and transforms, and change together.
22
- - **Technique:** Keep a small world spec (units, floor levels, player clearance, step and slope limits, which objects are solid and which decorative) and build both the visible mesh and its collider from one placement record. A door that opens, a platform that moves or a wall that breaks updates its collider in the same frame as its mesh.
23
- - **Reference configuration:** DK registers real colliders for solid props from the same seeded placement pass that dresses the map, and runs its clearance audits after decoration so they cover it. AW measures against the same part list it draws.
24
+ - **Technique:** Keep a small world spec (units, floor levels, player clearance, step and slope limits, which objects are solid and which decorative) and build both the visible mesh and its collider from one placement record. A door that opens, a platform that moves or a wall that breaks updates its collider in the same frame as its mesh. Break the picture, not the collider: bow a board or slump a sandbag in the mesh while its collider stays simple and in place.
25
+ - **Reference configuration:** DK registers real colliders for solid props from the same seeded placement pass that dresses the map, and runs its clearance audits after decoration so they cover it. AW measures against the same part list it draws. LC's layout lives in one plan module, and its builder "registers what is solid ... so nothing drawn here can be walked through and nothing solid is unseen".
24
26
  - **Applies when:** Every 3D game with a walking body.
25
- - **Verify:** Run the scene audit's colliders check (`opengame-scene-audit`); then open a door in play and walk through where it was.
26
-
27
- ### Every visible solid blocks or says why not
28
- - **Invariant:** A thing that looks solid stops the player, unless it carries an explicit reason it does not.
29
- - **Technique:** Give every visible mesh either a collider or a `nocollide` reason ("foliage", "decal", "distant scenery"). Fit the collider to the drawn shape, since a box smaller than the mesh lets bodies into its edges. Give decorative clutter a simple proxy shape instead of its render mesh, so small steps over rubble still work. Use nearby candidates or a spatial index for the query, never every render triangle every frame.
30
- - **Reference configuration:** AW's body-physics gate floods each map with a capsule from its spawns and reports any reachable position inside drawn opaque volume with no collider; it found bodies standing inside floor slabs that every grid check had passed. OC's palisade, fences, railings and roofs had no collider, its building boxes covered 84% of the footprint, and the owner reported walking through props about 7 times. OC's rubble kept its dense collision even when flagged non-solid.
31
- - **Applies when:** Every 3D game with a walking body.
32
- - **Verify:** Walk into representative walls, large props, closed doors, corners and the back and side of stairs, straight and diagonally and at full speed.
27
+ - **Verify:** Run the scene audit's colliders and invisible checks (`opengame-scene-audit`); then open a door in play and walk through where it was.
28
+
29
+ ### Collision is the picture, in both directions
30
+ - **Invariant:** Nothing drawn solid lets a body or a round through, nothing undrawn stops either, what can be seen through can be shot through, and any edge or ceiling a player can reach shows what stops them.
31
+ - **Technique:** Give each collider two shapes from the same placement: one for bodies and one for rounds and sight lines, fitted to the mesh. Collide props as their drawn mesh or a fitted proxy, give decorative clutter a simple proxy so small steps over rubble still work, and keep alpha-cutout leaves and foliage out of collision. Classify colliders by material flag or whole word, never a substring. Keep a boundary blocker only where the player can see why they stop. Query nearby candidates through a spatial index, never every render triangle. Hold it with three audits whose counts only go down (`opengame-scene-audit` has them): a probe body walked at every placed thing, a ray sweep from every reachable metre comparing the first drawn face with the first solid, and a check for solids where nothing is drawn.
32
+ - **Reference configuration:** OS: "still has a ton of invisible walls u cant walk or run or shoot through" (owner), at least 16 messages over ten days, from stale boxes under replaced rocks, colliders of removed gates (crawl ceilings of 1.2 to 1.45 m), clipped bushes (905 foliage kits on one map) and "'pine' inside 'alpine' and 'tree' inside 'street'"; on one map player walls went from 1,195 to 2 and bullet-stopping cells from 526 to 38, yet the class never closed: at the end another map still had 178 shot-through cells. LC: "u shouldnt be able to run through zombies we need proper object collision across the game" (owner); wire is a 2.1 m belt for bodies while only its pickets stop rounds, and a lorry is one box for bodies and 375 for rounds; walk-through things over 15 cm went from 935 to 0, rays through drawn faces from 13,033 to 6,671 against a known list that fails on anything new, solids with nothing drawn from 1,569 to 0; a sight line costs 5.8 µs and a body step 2.5 µs. OC's palisade, fences, railings and roofs had no collider, its building boxes covered 84% of the footprint, and the owner reported walking through props about 7 times. AW's capsule flood found bodies inside floor slabs that every grid check had passed.
33
+ - **Applies when:** Every 3D game with a walking body or projectiles.
34
+ - **Verify:** The three audits run on every change that touches placement; walk and sprint a player-sized body at every prop from four sides, and shoot through every fence a player can see through.
35
+
36
+ ### A pipeline that drops collision fails the build
37
+ - **Invariant:** No triangle budget, level-of-detail switch, proxy rule or failed asset load removes a collider without a count; every fallback is counted and gated per map.
38
+ - **Technique:** Log each collision fallback (too heavy to collide, stand-ins retired, props set down far) and gate the counts against the last good build, with hard caps on the share of walk-through and shot-through cells. Clear an authored solid only once its replacement mesh has loaded and is not empty, and never let a prop with no collision retire a stand-in. A number printed in a log that nothing reads is not a gate. After an engine upgrade, run one smoke that counts refused physics queries.
39
+ - **Reference configuration:** OS: one merged town grew from 149,046 to 153,260 triangles, past a silent 150k collision line, and the map had no walls for 4 days at an 8.5% walk-through share against 1% or less elsewhere, while the log printed the count: "It didn't miss it; nothing read the number." The fix: a hidden-face cut, a 600k tier in 32k chunks, and hard caps (too-heavy 0, walk 2%, shot 2%). Pots 0.599 m tall under a 0.6 m clutter line retired their stand-ins, 11 of 17 shot-throughs. A failed replacement load would have made 93 slabs and 45 cliffs walk-through. An engine port with 0 compile errors refused 256,072 distance queries in one smoke, so every wall read "clear".
40
+ - **Applies when:** Engines with collision tiers, stand-in colliders, streaming, or art passes over a blockout.
41
+ - **Verify:** Inject a missing model and an over-budget map: the gate fails, and the spot still blocks a walk and a shot.
42
+
43
+ ### Art passes never move gameplay geometry
44
+ - **Invariant:** Collision, spawns, perches, lanes, ladders and floor heights are identical before and after a fidelity pass, and dressing stays out of every opening, lane, landing and climb.
45
+ - **Technique:** Keep the gameplay layer and draw new art as display-only skins over it, such as one detailed model over hidden brushes whose collision stays. Hash the gameplay data after each pass and require an empty diff. Mark each place a player acts as a clearance volume (a lane, a doorway and the space in front of it, a lift's arc, a ladder top) and refuse any prop inside one. Keep clutter below the height that would make it a new perch, and inside a prop budget.
46
+ - **Reference configuration:** OS: one map's 1,081 brushes became one 87k-triangle model with "422,481 non-ring data scalars ... unchanged". Clutter stayed under 1.1 m "so none becomes a sniper perch", and 1,060 to 788 props read better; 6,042 scrub props crashed a map on load (budget about 3,000). Failures: a fidelity pass glazed an upstairs door, a pumpjack filled a ladder top, and an art change hid a stall from human testers. "we also shouldnt have flowers or leaves in front of any doorway" (owner); the keep-out became a doorway plus 2 m and no plant within 1.5 m of a door.
47
+ - **Applies when:** Any fidelity, dressing or reskin pass over a level that already plays.
48
+ - **Verify:** The gameplay hash diff is empty, no prop sits in a clearance volume, and a capsule walks every route and lift arc.
33
49
 
34
50
  ### A body at real scale
35
51
  - **Invariant:** The player's collision body is sized to the world it moves through, so doorways, steps, ledges and cover all work at the scale they are drawn.
36
52
  - **Technique:** A capsule or cylinder with a radius, a height and a step height chosen together with the level's door widths, riser heights and cover heights. Mantling has its own maximum height and needs a ledge deep enough to stand on.
37
- - **Reference configuration:** AW: radius 0.35 m, height 1.80 m, eye at 1.62 m, step 0.42 m, mantle up to 1.35 m onto a ledge at least 0.28 m deep within 0.85 m reach, over 0.55 s. Walk 4.9 m/s, sprint 6.9 m/s, jump velocity 4.5 against gravity 13.5. Bots use the same numbers, so what a player can climb a bot can.
53
+ - **Reference configuration:** AW: radius 0.35 m, height 1.80 m, eye at 1.62 m, step 0.42 m, mantle up to 1.35 m onto a ledge at least 0.28 m deep within 0.85 m reach, over 0.55 s. Walk 4.9 m/s, sprint 6.9 m/s, jump velocity 4.5 against gravity 13.5. Bots use the same numbers, so what a player can climb a bot can. LC: radius 0.34 m.
38
54
  - **Applies when:** First and third person at human scale. Top-down and side-on games pick their own body and say so in the world spec.
39
55
  - **Verify:** Walk the body through the narrowest doorway, onto the tallest step, and mantle the tallest intended ledge; all succeed, and the next height up fails.
40
56
 
57
+ ### Openings, stairs and ladders fit the largest body
58
+ - **Invariant:** Every door, window, stairwell, crawlway and ladder meant to be passable is passable standing, at walking speed, by the largest body that uses it, every climb leads somewhere, and low clearance blocks the player rather than changing their stance.
59
+ - **Technique:** Set minimum opening sizes in the generator from the largest capsule, and audit each build from cooked data, measuring the clear height inside the doorway so a porch counts. Walk the real controller through every opening to a goal past it, beside controls that must still block; a traversal test passes only when the body ends beyond the obstacle. Fix the stage a trace names, and never relax a slope, step or contact limit to clear a counter. Jump always releases a ladder.
60
+ - **Reference configuration:** OS: "doors that are too small or not wide enough or too short that u cant walk through" and "we cant have ladders that u can climb and cant get to the thing on top" (owner), 16 door messages and 7 ladder messages. Minimums: doors 1.4 m wide and 2.3 m clear, sills about 0.85 m, stairwell clearance 2.3 to 2.4 m (1.82 m stopped a 1.8 m capsule dead), 1.2 m clear past a ladder top. Undersized doors went from 14, 22, 16, 32 and 21 to 0 on five maps. "no part of any map where when u walk through it it makes u go prone automatically" (owner). A static doorway check passed doors the owner could not use. LC's number tests raised a 1.9 m door head to 2.05 m; its AI doorways are at least 1.3 m.
61
+ - **Applies when:** Any walkable map with doors, windows, stairs or ladders.
62
+ - **Verify:** The walk fails on the build before the fix and passes on the fix, and every control still blocks.
63
+
41
64
  ### Stairs are walked, never jumped
42
65
  - **Invariant:** Every staircase is climbable holding forward only, with no jump, snag, oscillation or launch, and cannot be entered through its side.
43
66
  - **Technique:** Either a fitted invisible ramp whose width, slope and joins at the top and bottom match the visible flight, with treads that never block, or a step-aware controller. After a step-up, place the body on the landing rather than letting it hover at the riser. Neither may bridge a real gap.
44
- - **Reference configuration:** AW and DK both use invisible ramps for flights. AW's validator drives the shipped controller up every flight with forward input only, and one flight once offered no drivable start at all, which a forward-only bot reports and a grid check does not. OC settled on a 0.4 m step-up after the owner raised stairs 3 times ("again these kind of stairs"). Its first controller "stopped dead at the 45° step-on". A capsule that lowered as soon as its centre crossed a curb's lip, with its rear still in the stone, crossed 0 of 64 curbs; after the fix it crossed 64 of 64. In three.js, Rapier's `KinematicCharacterController` has `enableAutostep` and `enableSnapToGround`.
67
+ - **Reference configuration:** AW and DK both use invisible ramps for flights. AW's validator drives the shipped controller up every flight with forward input only, and one flight once offered no drivable start at all, which a forward-only bot reports and a grid check does not. OC settled on a 0.4 m step-up after the owner raised stairs 3 times ("again these kind of stairs"); its first controller "stopped dead at the 45° step-on". A capsule that lowered as soon as its centre crossed a curb's lip, with its rear still in the stone, crossed 0 of 64 curbs; after the fix it crossed 64 of 64. OS: "running up stairs ... needs to be as if ur running up a fully smooth ramp" (owner), after a stair collider sat "half a step proud". In three.js, Rapier's `KinematicCharacterController` has `enableAutostep` and `enableSnapToGround`.
45
68
  - **Applies when:** Any game with stairs, steps or ledges a player should walk.
46
69
  - **Verify:** The walk bot in `opengame-scene-audit` climbs every flight with no jump input. By hand: approach at walking speed, cross the last riser onto the landing, turn, descend, then repeat diagonally and at sprint speed.
47
70
 
71
+ ### Step height comes from the smallest real obstacle, and gaps from the body's width
72
+ - **Invariant:** The player and enemies step over what a person steps over, are stopped by what stops a person, and are never held by a gap narrower than a body or a sliver they cannot see.
73
+ - **Technique:** Survey the smallest real obstacles on the paths players take (stumps, kerbs, stakes, rubble) and set the step from them, separately outdoors and indoors if they differ. Turn loose low things into walkable decks, give round things circle colliders, make every gap either wider than a body or closed, keep a clear margin along the first route a new player walks, and smooth the camera's rise separately from the feet.
74
+ - **Reference configuration:** LC: "we need proper object collision all around u shouldnt be able to walk through logs or piece s of wood (u or the zombies...) anywhere" (owner). Step 0.35 m outdoors ("a stump of 0.29 m stopped a running man" at 0.25) and 0.55 m indoors; loose things up to 60 cm become decks; gaps over 0.68 m (a body) or under 5 cm; 1.2 m kept clear along a run's first line, after a 3.5 cm stake 63 cm from a trunk stopped the player 21 times; the lens rises at most 2.1 cm a frame while the feet take a 21.9 cm step.
75
+ - **Applies when:** Every walkable 3D map, most of all cluttered outdoor ones.
76
+ - **Verify:** A fan of walks at every stake, sign and station, and a film of the feet over each obstacle class.
77
+
48
78
  ### The navigation step matches the body's step
49
79
  - **Invariant:** The navigation mesh's climb height, agent radius, agent height and slope limit match the movement body each AI uses, so every route the planner offers is one that body can walk.
50
- - **Technique:** Derive the navigation settings and the controller settings from one entry in the world spec. Anything the body must jump or drop down is a link (see `opengame-enemies`), never a walkable step. Snap knockback and hit-stagger to the ground so a hit cannot push a body off its route on a slope. In recast-navigation-js, Recast's `walkableClimb` and `walkableHeight` are counted in cells of height `ch`, so convert from metres and check the units in the version you use. Godot's `NavigationMesh.agent_max_climb` and a Unity agent type's Step Height are the same setting.
51
- - **Reference configuration:** OC's path map treated steps up to about 1.1 m as walkable while bodies could step 0.4 m, so the planner sent zombies up risers they could not climb, and 22 of 136 zombies were stuck in the fall state. OC's hit-stagger slid zombies down slopes because it had no ground snap.
80
+ - **Technique:** Derive the navigation settings and the controller settings from one entry in the world spec. Anything the body must jump or drop down is a link (see `opengame-enemies`), never a walkable step. Snap knockback and hit-stagger to the ground so a hit cannot push a body off its route on a slope. Flood the terrain alone for islands, and cap a slope rather than add a ramp. In recast-navigation-js, Recast's `walkableClimb` and `walkableHeight` are counted in cells of height `ch`, so convert from metres and check the units in the version you use. Godot's `NavigationMesh.agent_max_climb` and a Unity agent type's Step Height are the same setting.
81
+ - **Reference configuration:** OC's path map treated steps up to about 1.1 m as walkable while bodies could step 0.4 m, so the planner sent zombies up risers they could not climb, and 22 of 136 zombies were stuck in the fall state. OC's hit-stagger slid zombies down slopes because it had no ground snap. OS: a creek bank steeper than 45 degrees split its navigation mesh, and capping it at 32 took route failures from 38 to 0. LC's AI walks a flow field of 0.5 m cells, because a 0.8 m grid missed doors.
52
82
  - **Applies when:** Any game whose AI moves with a body along a navigation mesh or graph.
53
83
  - **Verify:** Read the navigation settings and the controller settings at runtime and compare them. Then drive one AI body along a path over every step height the level has: it stops at no riser the planner called walkable.
54
84
 
@@ -61,8 +91,8 @@ numbers below are at human scale in metres; scale them with the game.
61
91
 
62
92
  ### Depenetration is bounded
63
93
  - **Invariant:** A body found inside geometry is pushed out gently, by the side it entered, never teleported through or across the room.
64
- - **Technique:** Cap the correction per call and per frame, and share one budget across every sub-step and settle pass in the frame, because a per-call cap does not bound a frame that makes dozens of calls.
65
- - **Reference configuration:** AW caps depenetration at 0.06 m per call and 0.12 m per frame (about one frame of sprinting). Before the per-frame cap it measured 0.576 m of correction in one frame from capped calls into one pipe bundle, and 0.828 m when a body wedged under a truck.
94
+ - **Technique:** Cap the correction per call and per frame, and share one budget across every sub-step and settle pass in the frame, because a per-call cap does not bound a frame that makes dozens of calls. A capsule that starts wholly inside a one-sided mesh touches nothing, so test a start pose for overlap rather than sweeping from it.
95
+ - **Reference configuration:** AW caps depenetration at 0.06 m per call and 0.12 m per frame (about one frame of sprinting). Before the per-frame cap it measured 0.576 m of correction in one frame from capped calls into one pipe bundle, and 0.828 m when a body wedged under a truck. OS's spawn validator called 35 of 54 spawns on one map valid while they sat inside boulders: "A capsule wholly inside a one-sided mesh touches nothing".
66
96
  - **Applies when:** Every game that resolves overlaps.
67
97
  - **Verify:** Spawn a body overlapping a crate and record its position per frame: it leaves by the nearest face in small steps.
68
98
 
@@ -110,5 +140,6 @@ numbers below are at human scale in metres; scale them with the game.
110
140
 
111
141
  ## Further reading
112
142
 
113
- How AW measured its controller, and what each of its checks missed:
114
- [references/measured-failures.md](references/measured-failures.md).
143
+ How AW measured its controller, and what each game's collision checks missed:
144
+ [references/measured-failures.md](references/measured-failures.md). Spawns, lanes and the
145
+ map's affordances are in `opengame-maps`.
@@ -1,4 +1,6 @@
1
- # What AW's physics checks missed, and why
1
+ # What our physics checks missed, and why
2
+
3
+ ## World at War
2
4
 
3
5
  World at War (AW) built a headless gate for its maps after a player reported doors that
4
6
  led into rock, z-fighting, floating geometry and walking through stairs. On the day that
@@ -50,3 +52,28 @@ drive its movement function at the game's worst frame time and at 60 Hz.
50
52
  | Headroom | 1.80 m | The body's height |
51
53
  | Ladder landing | 0.20 m | A landing you step onto, not one you fall to |
52
54
  | Settle time at an edge | 1.5 s | A body walking off a terrace slides for over a second |
55
+
56
+ ## OG Snipers and Last Contact
57
+
58
+ OG Snipers (OS) and Last Contact (LC) met the same shape from the other side: checks
59
+ that read green while players met invisible walls and spawned inside rocks. The common
60
+ cause is in OS's own summary: the check reused the fix's inputs, or the check's path
61
+ differed from the player's.
62
+
63
+ | Check | It said | What was true |
64
+ | --- | --- | --- |
65
+ | OS spawn validator | Spawns valid | 35 of 54 spawns on one map inside drawn boulders: a capsule wholly inside a one-sided mesh touches nothing |
66
+ | OS spawn validator, again | Spawns valid | It ran before streamed rocks arrived, and a runtime adjuster moved spawns after it |
67
+ | OS spawn walk | Three spawns can escape | A 14 m walk test passed three spawns inside a 42 m² room; escape is now judged by reachable area |
68
+ | OS doorway heuristic | 0 blocked doors | The owner could not get through them; the served build was also stale |
69
+ | OS short sweeps | Spawn clear | Two spawns that passed were displaced over a metre in play |
70
+ | OS collision on one town | No alarm | The mesh crossed a 150k-triangle collision line and had no walls for 4 days |
71
+ | OS engine port | 0 compile errors | 256,072 refused distance queries in one smoke, so every wall read "clear" |
72
+ | OS integrity audit | 0/0/0 | Reached by adding filters; refused until every planted hole was flagged |
73
+ | OS route walk | Railing passes | The walk stopped 0.42 m short of the railing and called it arrived |
74
+ | LC walk tests | Wire is fine | Eight spawn points sat inside the wire belt's 2.1 m collider and stranded 20 of 75 points |
75
+ | LC z-fight mend | Fixed | Jambs every quarter metre of an arched doorway made a slat wall bodies walked through, on main for 8 hours, "found by a count, not by an eye" |
76
+
77
+ What replaced them was the same in both games: walk the real controller from every spawn
78
+ and at every placed thing, sweep rays from every reachable cell in both directions, plant
79
+ one defect per path the check covers, and let each count only go down.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@opengamehq/cli",
3
- "version": "0.9.8",
3
+ "version": "0.10.0",
4
4
  "description": "Deploy browser games to OpenGame from the command line.",
5
5
  "keywords": [
6
6
  "opengame",