@opengamehq/skills 1.3.0 → 1.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (385) hide show
  1. package/CHANGELOG.md +44 -0
  2. package/README.md +12 -4
  3. package/dist/.claude-plugin/marketplace.json +26 -0
  4. package/dist/skills/manifest.json +1409 -145
  5. package/dist/skills/opengame-accessibility/CHANGELOG.md +4 -0
  6. package/dist/skills/opengame-accessibility/SKILL.md +48 -32
  7. package/dist/skills/opengame-all-in-one/CHANGELOG.md +21 -0
  8. package/dist/skills/opengame-all-in-one/SKILL.md +195 -0
  9. package/dist/skills/opengame-all-in-one/references/opengame-accessibility/README.md +102 -0
  10. package/dist/skills/opengame-all-in-one/references/opengame-api/README.md +107 -0
  11. package/dist/skills/opengame-all-in-one/references/opengame-assets/README.md +168 -0
  12. package/dist/skills/opengame-all-in-one/references/opengame-assets/references/pipeline.md +164 -0
  13. package/dist/skills/opengame-all-in-one/references/opengame-audio/README.md +238 -0
  14. package/dist/skills/opengame-all-in-one/references/opengame-audio/helpers/audio-chain.js +325 -0
  15. package/dist/skills/opengame-all-in-one/references/opengame-audio/references/mix-notes.md +125 -0
  16. package/dist/skills/opengame-all-in-one/references/opengame-audio/references/qa-without-ears.md +177 -0
  17. package/dist/skills/opengame-all-in-one/references/opengame-capture/README.md +128 -0
  18. package/dist/skills/opengame-all-in-one/references/opengame-capture/references/pipeline.md +114 -0
  19. package/dist/skills/opengame-all-in-one/references/opengame-capture/references/threejs.md +161 -0
  20. package/dist/skills/opengame-all-in-one/references/opengame-characters/README.md +180 -0
  21. package/dist/skills/opengame-all-in-one/references/opengame-characters/references/first-person-body.md +108 -0
  22. package/dist/skills/opengame-all-in-one/references/opengame-characters/references/integration.md +144 -0
  23. package/dist/skills/opengame-all-in-one/references/opengame-characters/references/player-og.md +160 -0
  24. package/dist/skills/opengame-all-in-one/references/opengame-cli/README.md +189 -0
  25. package/dist/skills/opengame-all-in-one/references/opengame-deploy/README.md +223 -0
  26. package/dist/skills/opengame-all-in-one/references/opengame-deploy/references/json-events.md +63 -0
  27. package/dist/skills/opengame-all-in-one/references/opengame-deploy/references/manifest.md +89 -0
  28. package/dist/skills/opengame-all-in-one/references/opengame-deploy/references/packaging.md +119 -0
  29. package/dist/skills/opengame-all-in-one/references/opengame-depth/README.md +154 -0
  30. package/dist/skills/opengame-all-in-one/references/opengame-enemies/README.md +155 -0
  31. package/dist/skills/opengame-all-in-one/references/opengame-enemies/references/pacing-and-bots.md +108 -0
  32. package/dist/skills/opengame-all-in-one/references/opengame-enemies/references/threejs.md +193 -0
  33. package/dist/skills/opengame-all-in-one/references/opengame-front-end/README.md +185 -0
  34. package/dist/skills/opengame-all-in-one/references/opengame-front-end/references/launch.md +50 -0
  35. package/dist/skills/opengame-all-in-one/references/opengame-front-end/references/menus.md +81 -0
  36. package/dist/skills/opengame-all-in-one/references/opengame-game-feel/README.md +181 -0
  37. package/dist/skills/opengame-all-in-one/references/opengame-game-feel/helpers/spring.js +146 -0
  38. package/dist/skills/opengame-all-in-one/references/opengame-game-feel/references/feel-numbers.md +142 -0
  39. package/dist/skills/opengame-all-in-one/references/opengame-game-feel/references/killcam.md +88 -0
  40. package/dist/skills/opengame-all-in-one/references/opengame-jam/README.md +114 -0
  41. package/dist/skills/opengame-all-in-one/references/opengame-lighting/README.md +141 -0
  42. package/dist/skills/opengame-all-in-one/references/opengame-lighting/helpers/light-pool.js +185 -0
  43. package/dist/skills/opengame-all-in-one/references/opengame-loading/README.md +135 -0
  44. package/dist/skills/opengame-all-in-one/references/opengame-loading/helpers/loading-count.mjs +115 -0
  45. package/dist/skills/opengame-all-in-one/references/opengame-loading/references/threejs.md +141 -0
  46. package/dist/skills/opengame-all-in-one/references/opengame-look/README.md +181 -0
  47. package/dist/skills/opengame-all-in-one/references/opengame-look/references/matching-a-reference.md +73 -0
  48. package/dist/skills/opengame-all-in-one/references/opengame-look/references/painterly.md +69 -0
  49. package/dist/skills/opengame-all-in-one/references/opengame-look/references/post-and-lens.md +73 -0
  50. package/dist/skills/opengame-all-in-one/references/opengame-maps/README.md +74 -0
  51. package/dist/skills/opengame-all-in-one/references/opengame-maps/references/map-spec.md +77 -0
  52. package/dist/skills/opengame-all-in-one/references/opengame-mobile/README.md +86 -0
  53. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/README.md +183 -0
  54. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/briefs.md +293 -0
  55. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/day-one-questions.md +46 -0
  56. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/edge-cases.md +27 -0
  57. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/filmable.md +244 -0
  58. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/finishing.md +126 -0
  59. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/measure.md +282 -0
  60. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-capture.md +151 -0
  61. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-gates.md +84 -0
  62. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-genres.md +198 -0
  63. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-grammar.md +320 -0
  64. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-ops.md +127 -0
  65. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/og-snipers-record.md +110 -0
  66. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/owner-eye.md +214 -0
  67. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/reference-study.md +293 -0
  68. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/song.md +64 -0
  69. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/README.md +193 -0
  70. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/briefs.md +293 -0
  71. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/day-one-questions.md +46 -0
  72. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/filmable.md +244 -0
  73. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/measure.md +282 -0
  74. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-capture.md +151 -0
  75. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-gates.md +84 -0
  76. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-genres.md +198 -0
  77. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-grammar.md +320 -0
  78. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-ops.md +127 -0
  79. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/og-snipers-record.md +110 -0
  80. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/owner-eye.md +214 -0
  81. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/reference-study.md +293 -0
  82. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/song.md +64 -0
  83. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/README.md +174 -0
  84. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/briefs.md +293 -0
  85. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/day-one-questions.md +46 -0
  86. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/filmable.md +244 -0
  87. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/finishing.md +126 -0
  88. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/measure.md +282 -0
  89. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-capture.md +151 -0
  90. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-gates.md +84 -0
  91. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-genres.md +198 -0
  92. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-grammar.md +320 -0
  93. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-ops.md +127 -0
  94. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/og-snipers-record.md +110 -0
  95. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/owner-eye.md +214 -0
  96. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/reference-study.md +293 -0
  97. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/song.md +64 -0
  98. package/dist/skills/opengame-all-in-one/references/opengame-multiplayer/README.md +139 -0
  99. package/dist/skills/opengame-all-in-one/references/opengame-multiplayer/references/bot-lobbies.md +71 -0
  100. package/dist/skills/opengame-all-in-one/references/opengame-multiplayer/references/netcode.md +165 -0
  101. package/dist/skills/opengame-all-in-one/references/opengame-performance/README.md +177 -0
  102. package/dist/skills/opengame-all-in-one/references/opengame-performance/helpers/landing-pacer.mjs +86 -0
  103. package/dist/skills/opengame-all-in-one/references/opengame-performance/references/measuring.md +123 -0
  104. package/dist/skills/opengame-all-in-one/references/opengame-performance/references/webgpu.md +86 -0
  105. package/dist/skills/opengame-all-in-one/references/opengame-production/README.md +192 -0
  106. package/dist/skills/opengame-all-in-one/references/opengame-production/references/team.md +107 -0
  107. package/dist/skills/opengame-all-in-one/references/opengame-production/references/templates.md +153 -0
  108. package/dist/skills/opengame-all-in-one/references/opengame-quality-bar/README.md +170 -0
  109. package/dist/skills/opengame-all-in-one/references/opengame-quality-bar/references/cheap-tells.md +43 -0
  110. package/dist/skills/opengame-all-in-one/references/opengame-quality-bar/references/judges.md +95 -0
  111. package/dist/skills/opengame-all-in-one/references/opengame-quality-bar/references/review-prompt.md +32 -0
  112. package/dist/skills/opengame-all-in-one/references/opengame-rhythm/README.md +134 -0
  113. package/dist/skills/opengame-all-in-one/references/opengame-rhythm/references/charting.md +109 -0
  114. package/dist/skills/opengame-all-in-one/references/opengame-rhythm/references/timing.md +92 -0
  115. package/dist/skills/opengame-all-in-one/references/opengame-router/README.md +54 -0
  116. package/dist/skills/opengame-all-in-one/references/opengame-router/references/process.md +38 -0
  117. package/dist/skills/opengame-all-in-one/references/opengame-scene-audit/README.md +136 -0
  118. package/dist/skills/opengame-all-in-one/references/opengame-scene-audit/helpers/scene-audit.js +677 -0
  119. package/dist/skills/opengame-all-in-one/references/opengame-sdk/README.md +283 -0
  120. package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/engines.md +93 -0
  121. package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/frame.md +107 -0
  122. package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/identity.md +111 -0
  123. package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/leaderboards.md +115 -0
  124. package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/radio.md +71 -0
  125. package/dist/skills/opengame-all-in-one/references/opengame-stability/README.md +112 -0
  126. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/README.md +160 -0
  127. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/archetypes.md +113 -0
  128. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/briefs.md +273 -0
  129. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/core.md +129 -0
  130. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/craft.md +299 -0
  131. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/edge-cases.md +27 -0
  132. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/filmable.md +244 -0
  133. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/finishing.md +126 -0
  134. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/gates.md +184 -0
  135. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/measure.md +282 -0
  136. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/music.md +148 -0
  137. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/og-clash-record.md +133 -0
  138. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/ops.md +154 -0
  139. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/owner-eye.md +214 -0
  140. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/review.md +141 -0
  141. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/title.md +92 -0
  142. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/README.md +172 -0
  143. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/archetypes.md +113 -0
  144. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/briefs.md +273 -0
  145. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/core.md +129 -0
  146. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/craft.md +299 -0
  147. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/edge-cases.md +27 -0
  148. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/filmable.md +244 -0
  149. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/finishing.md +126 -0
  150. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/gates.md +184 -0
  151. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/measure.md +282 -0
  152. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/music.md +148 -0
  153. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/og-clash-record.md +133 -0
  154. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/ops.md +154 -0
  155. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/owner-eye.md +214 -0
  156. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/reference-set.md +92 -0
  157. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/review.md +141 -0
  158. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/title.md +92 -0
  159. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/README.md +141 -0
  160. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/archetypes.md +113 -0
  161. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/briefs.md +273 -0
  162. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/core.md +129 -0
  163. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/craft.md +299 -0
  164. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/edge-cases.md +27 -0
  165. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/filmable.md +244 -0
  166. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/finishing.md +126 -0
  167. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/gates.md +184 -0
  168. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/measure.md +282 -0
  169. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/music.md +148 -0
  170. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/og-clash-record.md +133 -0
  171. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/ops.md +154 -0
  172. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/owner-eye.md +214 -0
  173. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/review.md +141 -0
  174. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/title.md +92 -0
  175. package/dist/skills/opengame-all-in-one/references/opengame-verification/README.md +197 -0
  176. package/dist/skills/opengame-all-in-one/references/opengame-verification/helpers/browser-evidence.mjs +74 -0
  177. package/dist/skills/opengame-all-in-one/references/opengame-weapons/README.md +179 -0
  178. package/dist/skills/opengame-all-in-one/references/opengame-weapons/references/handling-numbers.md +114 -0
  179. package/dist/skills/opengame-all-in-one/references/opengame-weapons/references/reloads-and-hands.md +96 -0
  180. package/dist/skills/opengame-all-in-one/references/opengame-weapons/references/sights-and-scopes.md +98 -0
  181. package/dist/skills/opengame-all-in-one/references/opengame-weapons/references/threejs.md +240 -0
  182. package/dist/skills/opengame-all-in-one/references/opengame-world-physics/README.md +141 -0
  183. package/dist/skills/opengame-all-in-one/references/opengame-world-physics/references/measured-failures.md +79 -0
  184. package/dist/skills/opengame-api/CHANGELOG.md +12 -0
  185. package/dist/skills/opengame-api/SKILL.md +39 -13
  186. package/dist/skills/opengame-assets/CHANGELOG.md +11 -0
  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/CHANGELOG.md +11 -0
  190. package/dist/skills/opengame-audio/SKILL.md +129 -41
  191. package/dist/skills/opengame-audio/references/mix-notes.md +44 -1
  192. package/dist/skills/opengame-audio/references/qa-without-ears.md +177 -0
  193. package/dist/skills/opengame-capture/CHANGELOG.md +10 -0
  194. package/dist/skills/opengame-capture/SKILL.md +44 -20
  195. package/dist/skills/opengame-capture/references/pipeline.md +33 -1
  196. package/dist/skills/opengame-capture/references/threejs.md +17 -1
  197. package/dist/skills/opengame-characters/CHANGELOG.md +15 -0
  198. package/dist/skills/opengame-characters/SKILL.md +94 -39
  199. package/dist/skills/opengame-characters/references/first-person-body.md +108 -0
  200. package/dist/skills/opengame-characters/references/player-og.md +1 -1
  201. package/dist/skills/opengame-cli/CHANGELOG.md +20 -0
  202. package/dist/skills/opengame-cli/SKILL.md +12 -11
  203. package/dist/skills/opengame-deploy/CHANGELOG.md +30 -0
  204. package/dist/skills/opengame-deploy/SKILL.md +43 -23
  205. package/dist/skills/opengame-deploy/references/json-events.md +6 -5
  206. package/dist/skills/opengame-deploy/references/manifest.md +9 -3
  207. package/dist/skills/opengame-deploy/references/packaging.md +32 -30
  208. package/dist/skills/opengame-depth/CHANGELOG.md +8 -0
  209. package/dist/skills/opengame-depth/SKILL.md +61 -33
  210. package/dist/skills/opengame-enemies/CHANGELOG.md +10 -0
  211. package/dist/skills/opengame-enemies/SKILL.md +96 -40
  212. package/dist/skills/opengame-enemies/references/pacing-and-bots.md +108 -0
  213. package/dist/skills/opengame-enemies/references/threejs.md +59 -0
  214. package/dist/skills/opengame-front-end/CHANGELOG.md +4 -0
  215. package/dist/skills/opengame-front-end/SKILL.md +85 -39
  216. package/dist/skills/opengame-front-end/references/menus.md +42 -8
  217. package/dist/skills/opengame-game-feel/CHANGELOG.md +11 -0
  218. package/dist/skills/opengame-game-feel/SKILL.md +95 -47
  219. package/dist/skills/opengame-game-feel/references/feel-numbers.md +59 -0
  220. package/dist/skills/opengame-game-feel/references/killcam.md +88 -0
  221. package/dist/skills/opengame-jam/CHANGELOG.md +12 -0
  222. package/dist/skills/opengame-jam/SKILL.md +48 -33
  223. package/dist/skills/opengame-lighting/CHANGELOG.md +9 -0
  224. package/dist/skills/opengame-lighting/SKILL.md +85 -34
  225. package/dist/skills/opengame-loading/CHANGELOG.md +4 -0
  226. package/dist/skills/opengame-loading/SKILL.md +78 -38
  227. package/dist/skills/opengame-loading/helpers/loading-count.mjs +115 -0
  228. package/dist/skills/opengame-loading/references/threejs.md +32 -7
  229. package/dist/skills/opengame-look/CHANGELOG.md +9 -0
  230. package/dist/skills/opengame-look/SKILL.md +122 -51
  231. package/dist/skills/opengame-look/references/matching-a-reference.md +73 -0
  232. package/dist/skills/opengame-look/references/painterly.md +69 -0
  233. package/dist/skills/opengame-look/references/post-and-lens.md +10 -3
  234. package/dist/skills/opengame-maps/CHANGELOG.md +9 -0
  235. package/dist/skills/opengame-maps/SKILL.md +78 -0
  236. package/dist/skills/opengame-maps/references/map-spec.md +77 -0
  237. package/dist/skills/opengame-mobile/CHANGELOG.md +4 -0
  238. package/dist/skills/opengame-mobile/SKILL.md +18 -18
  239. package/dist/skills/opengame-montage-make/CHANGELOG.md +5 -0
  240. package/dist/skills/opengame-montage-make/SKILL.md +187 -0
  241. package/dist/skills/opengame-montage-make/references/briefs.md +293 -0
  242. package/dist/skills/opengame-montage-make/references/day-one-questions.md +46 -0
  243. package/dist/skills/opengame-montage-make/references/edge-cases.md +27 -0
  244. package/dist/skills/opengame-montage-make/references/filmable.md +244 -0
  245. package/dist/skills/opengame-montage-make/references/finishing.md +126 -0
  246. package/dist/skills/opengame-montage-make/references/measure.md +282 -0
  247. package/dist/skills/opengame-montage-make/references/montage-capture.md +151 -0
  248. package/dist/skills/opengame-montage-make/references/montage-gates.md +84 -0
  249. package/dist/skills/opengame-montage-make/references/montage-genres.md +198 -0
  250. package/dist/skills/opengame-montage-make/references/montage-grammar.md +320 -0
  251. package/dist/skills/opengame-montage-make/references/montage-ops.md +127 -0
  252. package/dist/skills/opengame-montage-make/references/og-snipers-record.md +110 -0
  253. package/dist/skills/opengame-montage-make/references/owner-eye.md +214 -0
  254. package/dist/skills/opengame-montage-make/references/reference-study.md +293 -0
  255. package/dist/skills/opengame-montage-make/references/song.md +64 -0
  256. package/dist/skills/opengame-montage-plan/CHANGELOG.md +5 -0
  257. package/dist/skills/opengame-montage-plan/SKILL.md +197 -0
  258. package/dist/skills/opengame-montage-plan/references/briefs.md +293 -0
  259. package/dist/skills/opengame-montage-plan/references/day-one-questions.md +46 -0
  260. package/dist/skills/opengame-montage-plan/references/filmable.md +244 -0
  261. package/dist/skills/opengame-montage-plan/references/measure.md +282 -0
  262. package/dist/skills/opengame-montage-plan/references/montage-capture.md +151 -0
  263. package/dist/skills/opengame-montage-plan/references/montage-gates.md +84 -0
  264. package/dist/skills/opengame-montage-plan/references/montage-genres.md +198 -0
  265. package/dist/skills/opengame-montage-plan/references/montage-grammar.md +320 -0
  266. package/dist/skills/opengame-montage-plan/references/montage-ops.md +127 -0
  267. package/dist/skills/opengame-montage-plan/references/og-snipers-record.md +110 -0
  268. package/dist/skills/opengame-montage-plan/references/owner-eye.md +214 -0
  269. package/dist/skills/opengame-montage-plan/references/reference-study.md +293 -0
  270. package/dist/skills/opengame-montage-plan/references/song.md +64 -0
  271. package/dist/skills/opengame-montage-review-and-improve/CHANGELOG.md +5 -0
  272. package/dist/skills/opengame-montage-review-and-improve/SKILL.md +178 -0
  273. package/dist/skills/opengame-montage-review-and-improve/references/briefs.md +293 -0
  274. package/dist/skills/opengame-montage-review-and-improve/references/day-one-questions.md +46 -0
  275. package/dist/skills/opengame-montage-review-and-improve/references/filmable.md +244 -0
  276. package/dist/skills/opengame-montage-review-and-improve/references/finishing.md +126 -0
  277. package/dist/skills/opengame-montage-review-and-improve/references/measure.md +282 -0
  278. package/dist/skills/opengame-montage-review-and-improve/references/montage-capture.md +151 -0
  279. package/dist/skills/opengame-montage-review-and-improve/references/montage-gates.md +84 -0
  280. package/dist/skills/opengame-montage-review-and-improve/references/montage-genres.md +198 -0
  281. package/dist/skills/opengame-montage-review-and-improve/references/montage-grammar.md +320 -0
  282. package/dist/skills/opengame-montage-review-and-improve/references/montage-ops.md +127 -0
  283. package/dist/skills/opengame-montage-review-and-improve/references/og-snipers-record.md +110 -0
  284. package/dist/skills/opengame-montage-review-and-improve/references/owner-eye.md +214 -0
  285. package/dist/skills/opengame-montage-review-and-improve/references/reference-study.md +293 -0
  286. package/dist/skills/opengame-montage-review-and-improve/references/song.md +64 -0
  287. package/dist/skills/opengame-multiplayer/CHANGELOG.md +15 -0
  288. package/dist/skills/opengame-multiplayer/SKILL.md +143 -0
  289. package/dist/skills/opengame-multiplayer/references/bot-lobbies.md +71 -0
  290. package/dist/skills/opengame-multiplayer/references/netcode.md +165 -0
  291. package/dist/skills/opengame-performance/CHANGELOG.md +8 -0
  292. package/dist/skills/opengame-performance/SKILL.md +106 -65
  293. package/dist/skills/opengame-performance/helpers/landing-pacer.mjs +86 -0
  294. package/dist/skills/opengame-performance/references/measuring.md +51 -0
  295. package/dist/skills/opengame-performance/references/webgpu.md +86 -0
  296. package/dist/skills/opengame-production/CHANGELOG.md +13 -0
  297. package/dist/skills/opengame-production/SKILL.md +119 -54
  298. package/dist/skills/opengame-production/references/team.md +107 -0
  299. package/dist/skills/opengame-production/references/templates.md +106 -16
  300. package/dist/skills/opengame-quality-bar/CHANGELOG.md +10 -0
  301. package/dist/skills/opengame-quality-bar/SKILL.md +94 -42
  302. package/dist/skills/opengame-quality-bar/references/cheap-tells.md +14 -7
  303. package/dist/skills/opengame-quality-bar/references/judges.md +95 -0
  304. package/dist/skills/opengame-quality-bar/references/review-prompt.md +10 -5
  305. package/dist/skills/opengame-rhythm/CHANGELOG.md +5 -0
  306. package/dist/skills/opengame-rhythm/SKILL.md +138 -0
  307. package/dist/skills/opengame-rhythm/references/charting.md +109 -0
  308. package/dist/skills/opengame-rhythm/references/timing.md +92 -0
  309. package/dist/skills/opengame-router/CHANGELOG.md +12 -0
  310. package/dist/skills/opengame-router/SKILL.md +14 -7
  311. package/dist/skills/opengame-scene-audit/CHANGELOG.md +15 -0
  312. package/dist/skills/opengame-scene-audit/SKILL.md +64 -47
  313. package/dist/skills/opengame-scene-audit/helpers/scene-audit.js +97 -19
  314. package/dist/skills/opengame-sdk/CHANGELOG.md +16 -0
  315. package/dist/skills/opengame-sdk/SKILL.md +27 -10
  316. package/dist/skills/opengame-sdk/references/engines.md +2 -2
  317. package/dist/skills/opengame-sdk/references/identity.md +10 -11
  318. package/dist/skills/opengame-sdk/references/leaderboards.md +11 -1
  319. package/dist/skills/opengame-sdk/references/radio.md +1 -1
  320. package/dist/skills/opengame-stability/CHANGELOG.md +4 -0
  321. package/dist/skills/opengame-stability/SKILL.md +59 -27
  322. package/dist/skills/opengame-trailer-make/CHANGELOG.md +5 -0
  323. package/dist/skills/opengame-trailer-make/SKILL.md +164 -0
  324. package/dist/skills/opengame-trailer-make/references/archetypes.md +113 -0
  325. package/dist/skills/opengame-trailer-make/references/briefs.md +273 -0
  326. package/dist/skills/opengame-trailer-make/references/core.md +129 -0
  327. package/dist/skills/opengame-trailer-make/references/craft.md +299 -0
  328. package/dist/skills/opengame-trailer-make/references/edge-cases.md +27 -0
  329. package/dist/skills/opengame-trailer-make/references/filmable.md +244 -0
  330. package/dist/skills/opengame-trailer-make/references/finishing.md +126 -0
  331. package/dist/skills/opengame-trailer-make/references/gates.md +184 -0
  332. package/dist/skills/opengame-trailer-make/references/measure.md +282 -0
  333. package/dist/skills/opengame-trailer-make/references/music.md +148 -0
  334. package/dist/skills/opengame-trailer-make/references/og-clash-record.md +133 -0
  335. package/dist/skills/opengame-trailer-make/references/ops.md +154 -0
  336. package/dist/skills/opengame-trailer-make/references/owner-eye.md +214 -0
  337. package/dist/skills/opengame-trailer-make/references/review.md +141 -0
  338. package/dist/skills/opengame-trailer-make/references/title.md +92 -0
  339. package/dist/skills/opengame-trailer-plan/CHANGELOG.md +5 -0
  340. package/dist/skills/opengame-trailer-plan/SKILL.md +176 -0
  341. package/dist/skills/opengame-trailer-plan/references/archetypes.md +113 -0
  342. package/dist/skills/opengame-trailer-plan/references/briefs.md +273 -0
  343. package/dist/skills/opengame-trailer-plan/references/core.md +129 -0
  344. package/dist/skills/opengame-trailer-plan/references/craft.md +299 -0
  345. package/dist/skills/opengame-trailer-plan/references/edge-cases.md +27 -0
  346. package/dist/skills/opengame-trailer-plan/references/filmable.md +244 -0
  347. package/dist/skills/opengame-trailer-plan/references/finishing.md +126 -0
  348. package/dist/skills/opengame-trailer-plan/references/gates.md +184 -0
  349. package/dist/skills/opengame-trailer-plan/references/measure.md +282 -0
  350. package/dist/skills/opengame-trailer-plan/references/music.md +148 -0
  351. package/dist/skills/opengame-trailer-plan/references/og-clash-record.md +133 -0
  352. package/dist/skills/opengame-trailer-plan/references/ops.md +154 -0
  353. package/dist/skills/opengame-trailer-plan/references/owner-eye.md +214 -0
  354. package/dist/skills/opengame-trailer-plan/references/reference-set.md +92 -0
  355. package/dist/skills/opengame-trailer-plan/references/review.md +141 -0
  356. package/dist/skills/opengame-trailer-plan/references/title.md +92 -0
  357. package/dist/skills/opengame-trailer-review-and-improve/CHANGELOG.md +5 -0
  358. package/dist/skills/opengame-trailer-review-and-improve/SKILL.md +145 -0
  359. package/dist/skills/opengame-trailer-review-and-improve/references/archetypes.md +113 -0
  360. package/dist/skills/opengame-trailer-review-and-improve/references/briefs.md +273 -0
  361. package/dist/skills/opengame-trailer-review-and-improve/references/core.md +129 -0
  362. package/dist/skills/opengame-trailer-review-and-improve/references/craft.md +299 -0
  363. package/dist/skills/opengame-trailer-review-and-improve/references/edge-cases.md +27 -0
  364. package/dist/skills/opengame-trailer-review-and-improve/references/filmable.md +244 -0
  365. package/dist/skills/opengame-trailer-review-and-improve/references/finishing.md +126 -0
  366. package/dist/skills/opengame-trailer-review-and-improve/references/gates.md +184 -0
  367. package/dist/skills/opengame-trailer-review-and-improve/references/measure.md +282 -0
  368. package/dist/skills/opengame-trailer-review-and-improve/references/music.md +148 -0
  369. package/dist/skills/opengame-trailer-review-and-improve/references/og-clash-record.md +133 -0
  370. package/dist/skills/opengame-trailer-review-and-improve/references/ops.md +154 -0
  371. package/dist/skills/opengame-trailer-review-and-improve/references/owner-eye.md +214 -0
  372. package/dist/skills/opengame-trailer-review-and-improve/references/review.md +141 -0
  373. package/dist/skills/opengame-trailer-review-and-improve/references/title.md +92 -0
  374. package/dist/skills/opengame-verification/CHANGELOG.md +11 -0
  375. package/dist/skills/opengame-verification/SKILL.md +113 -48
  376. package/dist/skills/opengame-weapons/CHANGELOG.md +11 -0
  377. package/dist/skills/opengame-weapons/SKILL.md +129 -55
  378. package/dist/skills/opengame-weapons/references/handling-numbers.md +42 -0
  379. package/dist/skills/opengame-weapons/references/reloads-and-hands.md +96 -0
  380. package/dist/skills/opengame-weapons/references/sights-and-scopes.md +98 -0
  381. package/dist/skills/opengame-weapons/references/threejs.md +71 -0
  382. package/dist/skills/opengame-world-physics/CHANGELOG.md +9 -0
  383. package/dist/skills/opengame-world-physics/SKILL.md +55 -24
  384. package/dist/skills/opengame-world-physics/references/measured-failures.md +28 -1
  385. package/package.json +1 -1
@@ -0,0 +1,141 @@
1
+ > Carried from `opengame-world-physics` 1.1.0. Read it when: 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.
2
+
3
+
4
+ # World physics for a walking player
5
+
6
+ What players report as "the physics is broken" is almost always one of a few mismatches:
7
+ something drawn that the collision layer does not know about, collision where nothing is
8
+ drawn, a staircase whose collision is a wall of risers, a fast body that skips a thin
9
+ floor in one frame, or a correction that teleports a body out of a corner. Each has a
10
+ known fix. The second, the invisible wall, was among the complaints our shooters' owners
11
+ repeated most, and the one the first version of these skills did not name.
12
+
13
+ Rules carry five tags; `opengame-quality-bar` explains them and the game codes. The
14
+ numbers below are at human scale in metres; scale them with the game.
15
+
16
+ ## Rules
17
+
18
+ ### One placement, two layers
19
+ - **Invariant:** What is drawn and what collides come from the same placements and transforms, and change together.
20
+ - **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.
21
+ - **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".
22
+ - **Applies when:** Every 3D game with a walking body.
23
+ - **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.
24
+
25
+ ### Collision is the picture, in both directions
26
+ - **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.
27
+ - **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.
28
+ - **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.
29
+ - **Applies when:** Every 3D game with a walking body or projectiles.
30
+ - **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.
31
+
32
+ ### A pipeline that drops collision fails the build
33
+ - **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.
34
+ - **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.
35
+ - **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".
36
+ - **Applies when:** Engines with collision tiers, stand-in colliders, streaming, or art passes over a blockout.
37
+ - **Verify:** Inject a missing model and an over-budget map: the gate fails, and the spot still blocks a walk and a shot.
38
+
39
+ ### Art passes never move gameplay geometry
40
+ - **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.
41
+ - **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.
42
+ - **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.
43
+ - **Applies when:** Any fidelity, dressing or reskin pass over a level that already plays.
44
+ - **Verify:** The gameplay hash diff is empty, no prop sits in a clearance volume, and a capsule walks every route and lift arc.
45
+
46
+ ### A body at real scale
47
+ - **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.
48
+ - **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.
49
+ - **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.
50
+ - **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.
51
+ - **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.
52
+
53
+ ### Openings, stairs and ladders fit the largest body
54
+ - **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.
55
+ - **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.
56
+ - **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.
57
+ - **Applies when:** Any walkable map with doors, windows, stairs or ladders.
58
+ - **Verify:** The walk fails on the build before the fix and passes on the fix, and every control still blocks.
59
+
60
+ ### Stairs are walked, never jumped
61
+ - **Invariant:** Every staircase is climbable holding forward only, with no jump, snag, oscillation or launch, and cannot be entered through its side.
62
+ - **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.
63
+ - **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`.
64
+ - **Applies when:** Any game with stairs, steps or ledges a player should walk.
65
+ - **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.
66
+
67
+ ### Step height comes from the smallest real obstacle, and gaps from the body's width
68
+ - **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.
69
+ - **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.
70
+ - **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.
71
+ - **Applies when:** Every walkable 3D map, most of all cluttered outdoor ones.
72
+ - **Verify:** A fan of walks at every stake, sign and station, and a film of the feet over each obstacle class.
73
+
74
+ ### The navigation step matches the body's step
75
+ - **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.
76
+ - **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.
77
+ - **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.
78
+ - **Applies when:** Any game whose AI moves with a body along a navigation mesh or graph.
79
+ - **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.
80
+
81
+ ### Nothing tunnels
82
+ - **Invariant:** No body passes through a wall or a thin floor at any frame rate the game can run at, including its worst.
83
+ - **Technique:** Sweep or sub-step horizontal and vertical motion so each sub-step is shorter than the thinnest solid, and settle with a few passes per sub-step so corners converge.
84
+ - **Reference configuration:** AW sub-steps at `max(0.05, radius * 0.45)` with up to 8 settle passes, and tests at its own worst frame (`dt` clamped to 0.05 s) as well as at 60 Hz.
85
+ - **Applies when:** Every game with moving bodies and thin geometry.
86
+ - **Verify:** Sprint into a thin wall and drop onto a thin floor with the frame time pinned at the game's clamp; the body stays on the near side.
87
+
88
+ ### Depenetration is bounded
89
+ - **Invariant:** A body found inside geometry is pushed out gently, by the side it entered, never teleported through or across the room.
90
+ - **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.
91
+ - **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".
92
+ - **Applies when:** Every game that resolves overlaps.
93
+ - **Verify:** Spawn a body overlapping a crate and record its position per frame: it leaves by the nearest face in small steps.
94
+
95
+ ### Support after the clamp
96
+ - **Invariant:** The question "what is under the body" is asked at the position the body ends up in, after every clamp and constraint.
97
+ - **Technique:** Resolve bounds and constraints first, then query support at the final position. Test every edge of every walkable zone, not only interiors.
98
+ - **Reference configuration:** AW's player fell under its map at the play boundary because support was resolved before the boundary clamp; every interior-only sweep reported zero on the day a player filmed it.
99
+ - **Applies when:** Any game with play bounds, ledges or walkable zones.
100
+ - **Verify:** Walk the body into every perimeter at the worst frame time and check it ends at rest on a floor, not under one.
101
+
102
+ ### A fixed simulation step
103
+ - **Invariant:** Simulation advances in fixed steps, independent of render rate, with bounded catch-up after a hitch or a hidden tab.
104
+ - **Technique:** An accumulator that runs whole fixed steps and interpolates the render, a cap on steps per frame, and a fresh time baseline after pause or visibility changes.
105
+ - **Reference configuration:** 1/60 s steps in DK, MC and AW; AW clamps a frame to 0.05 s before integrating.
106
+ - **Applies when:** Every game with physics or movement.
107
+ - **Verify:** Run the same input recording at 30, 60 and 144 fps; the body ends in the same place.
108
+
109
+ ### Forgiving jumps
110
+ - **Invariant:** A jump pressed just before landing or just after walking off a ledge still happens.
111
+ - **Technique:** Coyote time after leaving the ground and a jump buffer before landing, both consumed in the simulation step that uses them, never in a render-only frame.
112
+ - **Reference configuration:** AW: coyote 0.12 s, jump buffer 0.16 s.
113
+ - **Applies when:** Games with jumping, platformers above all. Turn it off where precision is the challenge, and say so.
114
+ - **Verify:** Press jump a few frames late off a ledge and a few frames early before landing; both jump.
115
+
116
+ ### Ragdolls settle, then stop
117
+ - **Invariant:** A body that dies falls with weight, comes to rest on real geometry soon after, and does not spin, launch, shake or float.
118
+ - **Technique:** Play a directional death clip first and hand the body to physics near its end. Push the body out of any solid it starts in when the ragdoll activates. Cap and damp angular velocity per part, and check whether the physics engine reads angular velocity in world space or in the body's own frame before writing it. When motion stays under a threshold for a short time, freeze the pose and take the parts out of the solver. Judge the result on side-by-side video as well as spin numbers. In three.js with Rapier use `setAngvel`, `setAngularDamping`, `isSleeping()` and `sleep()`; cannon-es has `allowSleep`, `sleepSpeedLimit` and `angularDamping`.
119
+ - **Reference configuration:** OC cut corpse spin from 25.6 to 3.0 rad/s (R158), against a target of under 3 rad/s by 1.5 s and an 8 rad/s clamp, and cut knee swing-twist from 121 to 17 rad/s and elbow from 132 to 25 (R105 to R107). Its earlier spikes came from a world-space roll written to a body-frame input (limbs at 25.6 rad/s), cached joint impulses (the full rig failed after 13 steps on a flat floor, and held for 600 once reset) and a body that died buried in a solid (188.97 rad/s). OC's plan for the handover was the death clip first, physics for the last 0.15 s, ragdoll time per kill down from 3.8 s to 1.75 s. Raising corpse inertia 8 times improved the spin numbers, looked worse in a blind review, and was reverted. The owner raised spasming corpses about 8 times.
120
+ - **Applies when:** Any game with ragdolls or physics corpses.
121
+ - **Verify:** Kill enemies with each weapon class on flat ground, slopes, stairs and against walls. Log peak angular speed per part and the speed 1.5 s after death, and watch the clips beside the reference game.
122
+
123
+ ### Corpses retire on game-time deadlines
124
+ - **Invariant:** Every corpse and piece of debris leaves within a fixed game-time deadline, and the count of simulated bodies has a cap, whatever the solver does and at any frame rate.
125
+ - **Technique:** Drive corpse timers from the game clock, not from solver step counts. Sink or fade each corpse at its deadline and sweep any that remain. Cap active ragdolls and give far or excess kills a death clip only. Turn off corpse-against-corpse collision. A dead body stops counting as a target the frame it dies.
126
+ - **Reference configuration:** OC sinks corpses by 8 s and sweeps visible ones at 10 s (R183), caps ragdolls at 112 in total, and retires any past 8 active or 30 m away. Its rule after the fact: never tie corpse timers to solver step counts.
127
+ - **Applies when:** Any game that leaves bodies or debris, hordes above all.
128
+ - **Verify:** Run a 10-minute horde at the lowest frame rate the game supports (throttle the CPU) and count live corpses each second: each leaves by its deadline and the count stays under the cap.
129
+
130
+ ### Ray queries are budgeted by length and count
131
+ - **Invariant:** Each frame's ray and shape queries fit a budget, however many enemies there are and wherever the player looks.
132
+ - **Technique:** Clip every ray to the bounds of what it can hit and give it the shortest useful length. Query a broadphase or a bounding volume tree, against simple collider shapes rather than render meshes. Spread searches (camera placement, escape routes, cover) across frames, and back off after a failed search instead of repeating it every frame. Count queries per frame in the profiler. In three.js set `Raycaster.far` and use three-mesh-bvh (`computeBoundsTree`, `acceleratedRaycast`, `firstHitOnly`); Rapier's `castRay` takes a maximum time of impact.
133
+ - **Reference configuration:** OC cast about 670 rays a frame and got 100 to 540 ms frames until the rays were clipped to the collider bounds. Its 11,000-ray camera search ran spread over 16 frames. 88 bodies made 1,000 to 1,600 physics queries a frame.
134
+ - **Applies when:** Any game with aim rays, line of sight, camera collision or AI queries.
135
+ - **Verify:** Log query count and query time per frame through a full horde round and an ending. Aim at the sky, at the farthest wall and into a crowd: the worst frame stays inside the budget.
136
+
137
+ ## Further reading
138
+
139
+ How AW measured its controller, and what each game's collision checks missed:
140
+ [references/measured-failures.md](references/measured-failures.md). Spawns, lanes and the
141
+ map's affordances are in `opengame-maps`.
@@ -0,0 +1,79 @@
1
+ # What our physics checks missed, and why
2
+
3
+ ## World at War
4
+
5
+ World at War (AW) built a headless gate for its maps after a player reported doors that
6
+ led into rock, z-fighting, floating geometry and walking through stairs. On the day that
7
+ gate first reported zero physics findings on all three maps, a player walked through a
8
+ staircase, ended up inside a floor and spawned inside a wall. Six mechanisms let it:
9
+
10
+ 1. **The grid asked a question the controller never asks.** Walkable cells were found
11
+ with a standing-clearance test the shipped controller does not use, so the grid's
12
+ idea of where a body could be was not the controller's.
13
+ 2. **"Feet inside solid" tested a point at the ankles.** A wall through the shoulder, a
14
+ sill through the chest and a slab through the head were all invisible. Testing a
15
+ circle of the body's radius over its whole height found 25 bad spawns on one map, 16
16
+ on another and 5 on a third, where the point test had found none.
17
+ 3. **An exemption was unconditional.** Bullet-only volumes inside a ramp's footprint were
18
+ exempt at any height, which hid a solid block of ground. The rule now asks what the
19
+ body is inside, not where it is standing.
20
+ 4. **Nothing swept.** A grid samples positions; a body that moves fast enough is never
21
+ sampled inside the thin thing it passes through.
22
+ 5. **Published floor levels were never asked whether a body fits on them.**
23
+ 6. **The edge was excluded by construction.** Interior sweeps refuse columns near a lip,
24
+ because stepping off a lip is allowed. Every fall-through a player suffered
25
+ was at exactly those columns.
26
+
27
+ What replaced it: **geometry proposes, the shipped controller disposes.** Flood each map
28
+ with a capsule from its spawn points using the controller's own traversal rules,
29
+ standing then crouched, to get the set of places a body can be. Then press keys on the
30
+ real player controller at that set's frontier (jump, mantle, ladder, slide, crouch) and
31
+ drive its movement function at the game's worst frame time and at 60 Hz.
32
+
33
+ ## Two rules worth taking from it
34
+
35
+ - **A zero and an unexercised check print the same number.** Report how many things each
36
+ check examined, report an arm with no subjects as a failure, and say when a staircase
37
+ offered no drivable start.
38
+ - **Replaying stored findings is a smoke test, not a fix rate.** After a solver change,
39
+ AW replayed 344 stored findings and read 185 as gone; a fresh measurement found 165 of
40
+ those 185 still present at the same place. A solver change perturbs the path, and a
41
+ map edit renumbers parts, so a stored position no longer arrives where it did. Measure
42
+ fresh on both sides of every before and after.
43
+
44
+ ## Tolerances AW settled on
45
+
46
+ | Name | Value | Why |
47
+ | --- | --- | --- |
48
+ | Grid cell | 0.5 m | A body is 0.70 m across, so nothing body-sized hides between samples |
49
+ | Floor agreement | 0.15 m | One riser is about 0.10 m; more than this and the gap shows |
50
+ | On a ramp | one step, 0.42 m | A drawn tread and a straight ramp differ by up to a riser |
51
+ | Doorway width | 0.60 to 3.20 m | Narrower is a crack, wider is a missing wall |
52
+ | Headroom | 1.80 m | The body's height |
53
+ | Ladder landing | 0.20 m | A landing you step onto, not one you fall to |
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.
@@ -1,5 +1,17 @@
1
1
  # opengame-api changelog
2
2
 
3
+ ## 1.0.7
4
+
5
+ Deploying without the CLI starts from `GET /api/v1/bootstrap` and its capabilities. An archive over 500 MiB goes in parts (`"multipart": true` and `/api/v1/operations/{id}/upload/parts`) or is refused with 413 `bundle_limit`, and a file-by-file deploy (`/api/v1/deploys/files`) sends only the files OpenGame does not already hold. Names the daily deploy allowance, 5 in any rolling 24 hours (`deploy_day_limited`), beside the hourly one. A ready deploy goes to review by itself.
6
+
7
+ ## 1.0.6
8
+
9
+ Any signed-in account can use the CLI, the creator API, uploads and jam entries before launch, so a `not_launched` answer means the request came with no account: sign in (`opengame login`) and run it again rather than waiting for 18 November.
10
+
11
+ ## 1.0.5
12
+
13
+ OpenGame opens on 18 November 2026, the jam's kickoff, not 17 November: the site no longer opens a day before the rest.
14
+
3
15
  ## 1.0.4
4
16
 
5
17
  The site opens on one day and the CLI, uploads and the creator API on the next, the jam's kickoff. Until then an account outside the team is told that day, read from the launch clock.
@@ -2,22 +2,22 @@
2
2
  name: opengame-api
3
3
  description: Call the OpenGame creator API directly over HTTPS. Covers the base URL, creator tokens and scopes, the OpenAPI document, the error shape and retry fields, deploying without the CLI, and checking whether OpenGame is open. Use when the person wants to deploy from their own tool or CI without the CLI, asks about the OpenGame REST API, api/v1, openapi.json or a creator token, or an API call returned an error code you need to read.
4
4
  metadata:
5
- version: "1.0.4"
5
+ version: "1.0.7"
6
6
  ---
7
7
 
8
8
  # Call the OpenGame creator API
9
9
 
10
- OpenGame opens on 17 November 2026, and the creator API on 18 November. Until 18 November, every route except the status route and sign-in answers 403
11
- with the error `not_launched` and the message "OpenGame opens for creators on 18 November." for any account
12
- outside the OpenGame team. Check before anything else:
10
+ OpenGame opens on 18 November 2026. The creator API takes any signed-in
11
+ account now; until 18 November a request with no account answers 403 `not_launched`,
12
+ and the CLI says "OpenGame opens for creators on 18 November." Check before anything else:
13
13
 
14
14
  ```bash
15
15
  curl -s https://opengame.io/api/v1/status
16
16
  ```
17
17
 
18
- It answers `{ "launched": false, "access": null }` before launch. Sent with a token,
19
- `access` says whether that account may use OpenGame now. Do not retry a
20
- `not_launched` refusal in a loop; tell the person.
18
+ It answers `{ "launched": false, "access": null }` before launch with no token. Sent with
19
+ a token, `access` says whether that account may use OpenGame now, and is `true` for any
20
+ account. Do not retry a `not_launched` refusal in a loop; sign in, or tell the person.
21
21
 
22
22
  Most integrations should run the CLI (`opengame-cli`), which builds, checks, packages
23
23
  and resumes uploads. Use the API when the CLI cannot run.
@@ -47,16 +47,42 @@ authentication it needs. Read it rather than guessing a field.
47
47
 
48
48
  ## Deploy without the CLI
49
49
 
50
+ Start with `GET /api/v1/bootstrap`. It returns the limits, the account's usage and
51
+ `capabilities`, which say what this account may use now: `archiveParts` (an archive in
52
+ parts), `incrementalUpload` (file by file), `fileParts`, `filePacks` and `externalAssets`.
53
+ Use a way of uploading only when its capability is `true`.
54
+
55
+ An archive deploy:
56
+
50
57
  1. `POST /api/v1/deploys` with the archive's size, file count, SHA-256 hash and manifest, and
51
- an `Idempotency-Key`. Save the operation ID and the key before uploading.
52
- 2. `PUT` the archive bytes to the returned `upload` URL with the headers it names, and
53
- no creator token.
58
+ an `Idempotency-Key`. Save the operation ID and the key before uploading. Add
59
+ `"multipart": true` to send an archive over 64 MiB
60
+ in parts: the answer then carries `multipart` (the part size, the part count and the
61
+ parts already stored) in place of `upload`. Without it, an archive over
62
+ 500 MiB is refused with 413 `bundle_limit`.
63
+ 2. One `PUT` of the archive bytes to the returned `upload` URL, with the headers it names
64
+ and no creator token. In parts: `POST /api/v1/operations/{id}/upload/parts` with
65
+ `{"parts": [1, 2, ...]}` (up to 64 a
66
+ request) signs a URL for each, then `PUT` each part to its URL, up to
67
+ 16 at once.
54
68
  3. `PUT /api/v1/operations/{id}/upload` to confirm. A `POST` to the same path gives a
55
- fresh upload URL if the upload was interrupted.
69
+ fresh upload URL, or for parts the ones storage already holds, if the upload was
70
+ interrupted.
56
71
  4. Poll `GET /api/v1/operations/{id}` until it is `ready`, `failed` or `expired`.
57
72
 
73
+ A file-by-file deploy sends only the files OpenGame does not already hold, so a small
74
+ change to a big game uploads little. `POST /api/v1/deploys/files` starts it from a list of
75
+ files with their hashes, the `/api/v1/operations/{id}/files/...` routes sign, verify and
76
+ pack the missing ones, and `POST /api/v1/operations/{id}/files/complete` assembles the
77
+ build and queues the checks. The request bodies are in `openapi.json`.
78
+
58
79
  Reuse one `Idempotency-Key` for every retry of the same deploy; a new key starts a new
59
- operation. Submitting a release to review is separate: `POST /api/v1/submissions`.
80
+ operation. A ready deploy goes to review by itself, and the creator confirms its details
81
+ on the deploy's page.
82
+
83
+ An account may begin 5 deploys in any rolling 24
84
+ hours (429 `deploy_day_limited`), and has an hourly allowance too (429
85
+ `deploy_rate_limited`). A refused deploy uploads nothing; wait and try again.
60
86
 
61
87
  ## Errors
62
88
 
@@ -72,7 +98,7 @@ on `error`. Other fields, when present:
72
98
 
73
99
  Some answers to know:
74
100
 
75
- - `not_launched` (403): OpenGame has not opened yet for this account.
101
+ - `not_launched` (403): the request came with no account before launch. Sign in.
76
102
  - `not_member` or `account_inactive` (403): the account has no access, or is suspended.
77
103
  - `uploads_closed` (403): new uploads are not open to this account; nothing started.
78
104
  - `entries_closed` (403, `retry` is `never`): entries have closed, so no game can be
@@ -1,5 +1,16 @@
1
1
  # opengame-assets changelog
2
2
 
3
+ ## 1.1.0
4
+
5
+ Adds what Last Contact (LC), OG Snipers (OS) and OG Hero (OH) taught about sourcing assets:
6
+ prove one route end to end before a batch, buying tools that run dry by default, artists'
7
+ models for what the player holds with generation kept to bodies, far props and variety, a
8
+ studio render beside a real photograph as the gate, grading every generated or scanned
9
+ material, licences on file for every asset, generated photographs used for composition
10
+ only, and git that never rewrites a binary file. The rigging rule now keeps the exact
11
+ mesh a paid rig was made on and points to `opengame-characters` for ordering and re-baking
12
+ generated people.
13
+
3
14
  ## 1.0.0
4
15
 
5
16
  First public release, in the opengamehq/opengame repository and the OpenGame CLI.