@opengamehq/cli 0.9.8 → 0.9.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (349) hide show
  1. package/AGENTS.md +37 -17
  2. package/CHANGELOG.md +11 -0
  3. package/README.md +7 -6
  4. package/dist/cli.mjs +135 -135
  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 +1406 -142
  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 +107 -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 +189 -0
  27. package/dist/skills/opengame-all-in-one/references/opengame-deploy/README.md +223 -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 +89 -0
  30. package/dist/skills/opengame-all-in-one/references/opengame-deploy/references/packaging.md +119 -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 +114 -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 +32 -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 +4 -4
  199. package/dist/skills/opengame-deploy/SKILL.md +35 -15
  200. package/dist/skills/opengame-deploy/references/json-events.md +6 -5
  201. package/dist/skills/opengame-deploy/references/packaging.md +28 -26
  202. package/dist/skills/opengame-depth/SKILL.md +61 -33
  203. package/dist/skills/opengame-enemies/SKILL.md +96 -40
  204. package/dist/skills/opengame-enemies/references/pacing-and-bots.md +108 -0
  205. package/dist/skills/opengame-enemies/references/threejs.md +59 -0
  206. package/dist/skills/opengame-front-end/SKILL.md +85 -39
  207. package/dist/skills/opengame-front-end/references/menus.md +42 -8
  208. package/dist/skills/opengame-game-feel/SKILL.md +95 -47
  209. package/dist/skills/opengame-game-feel/references/feel-numbers.md +59 -0
  210. package/dist/skills/opengame-game-feel/references/killcam.md +88 -0
  211. package/dist/skills/opengame-jam/SKILL.md +42 -27
  212. package/dist/skills/opengame-lighting/SKILL.md +85 -34
  213. package/dist/skills/opengame-loading/SKILL.md +78 -38
  214. package/dist/skills/opengame-loading/helpers/loading-count.mjs +115 -0
  215. package/dist/skills/opengame-loading/references/threejs.md +32 -7
  216. package/dist/skills/opengame-look/SKILL.md +122 -51
  217. package/dist/skills/opengame-look/references/matching-a-reference.md +73 -0
  218. package/dist/skills/opengame-look/references/painterly.md +69 -0
  219. package/dist/skills/opengame-look/references/post-and-lens.md +10 -3
  220. package/dist/skills/opengame-maps/SKILL.md +78 -0
  221. package/dist/skills/opengame-maps/references/map-spec.md +77 -0
  222. package/dist/skills/opengame-mobile/SKILL.md +18 -18
  223. package/dist/skills/opengame-montage-make/SKILL.md +187 -0
  224. package/dist/skills/opengame-montage-make/references/briefs.md +293 -0
  225. package/dist/skills/opengame-montage-make/references/day-one-questions.md +46 -0
  226. package/dist/skills/opengame-montage-make/references/edge-cases.md +27 -0
  227. package/dist/skills/opengame-montage-make/references/filmable.md +244 -0
  228. package/dist/skills/opengame-montage-make/references/finishing.md +126 -0
  229. package/dist/skills/opengame-montage-make/references/measure.md +282 -0
  230. package/dist/skills/opengame-montage-make/references/montage-capture.md +151 -0
  231. package/dist/skills/opengame-montage-make/references/montage-gates.md +84 -0
  232. package/dist/skills/opengame-montage-make/references/montage-genres.md +198 -0
  233. package/dist/skills/opengame-montage-make/references/montage-grammar.md +320 -0
  234. package/dist/skills/opengame-montage-make/references/montage-ops.md +127 -0
  235. package/dist/skills/opengame-montage-make/references/og-snipers-record.md +110 -0
  236. package/dist/skills/opengame-montage-make/references/owner-eye.md +214 -0
  237. package/dist/skills/opengame-montage-make/references/reference-study.md +293 -0
  238. package/dist/skills/opengame-montage-make/references/song.md +64 -0
  239. package/dist/skills/opengame-montage-plan/SKILL.md +197 -0
  240. package/dist/skills/opengame-montage-plan/references/briefs.md +293 -0
  241. package/dist/skills/opengame-montage-plan/references/day-one-questions.md +46 -0
  242. package/dist/skills/opengame-montage-plan/references/filmable.md +244 -0
  243. package/dist/skills/opengame-montage-plan/references/measure.md +282 -0
  244. package/dist/skills/opengame-montage-plan/references/montage-capture.md +151 -0
  245. package/dist/skills/opengame-montage-plan/references/montage-gates.md +84 -0
  246. package/dist/skills/opengame-montage-plan/references/montage-genres.md +198 -0
  247. package/dist/skills/opengame-montage-plan/references/montage-grammar.md +320 -0
  248. package/dist/skills/opengame-montage-plan/references/montage-ops.md +127 -0
  249. package/dist/skills/opengame-montage-plan/references/og-snipers-record.md +110 -0
  250. package/dist/skills/opengame-montage-plan/references/owner-eye.md +214 -0
  251. package/dist/skills/opengame-montage-plan/references/reference-study.md +293 -0
  252. package/dist/skills/opengame-montage-plan/references/song.md +64 -0
  253. package/dist/skills/opengame-montage-review-and-improve/SKILL.md +178 -0
  254. package/dist/skills/opengame-montage-review-and-improve/references/briefs.md +293 -0
  255. package/dist/skills/opengame-montage-review-and-improve/references/day-one-questions.md +46 -0
  256. package/dist/skills/opengame-montage-review-and-improve/references/filmable.md +244 -0
  257. package/dist/skills/opengame-montage-review-and-improve/references/finishing.md +126 -0
  258. package/dist/skills/opengame-montage-review-and-improve/references/measure.md +282 -0
  259. package/dist/skills/opengame-montage-review-and-improve/references/montage-capture.md +151 -0
  260. package/dist/skills/opengame-montage-review-and-improve/references/montage-gates.md +84 -0
  261. package/dist/skills/opengame-montage-review-and-improve/references/montage-genres.md +198 -0
  262. package/dist/skills/opengame-montage-review-and-improve/references/montage-grammar.md +320 -0
  263. package/dist/skills/opengame-montage-review-and-improve/references/montage-ops.md +127 -0
  264. package/dist/skills/opengame-montage-review-and-improve/references/og-snipers-record.md +110 -0
  265. package/dist/skills/opengame-montage-review-and-improve/references/owner-eye.md +214 -0
  266. package/dist/skills/opengame-montage-review-and-improve/references/reference-study.md +293 -0
  267. package/dist/skills/opengame-montage-review-and-improve/references/song.md +64 -0
  268. package/dist/skills/opengame-multiplayer/SKILL.md +143 -0
  269. package/dist/skills/opengame-multiplayer/references/bot-lobbies.md +71 -0
  270. package/dist/skills/opengame-multiplayer/references/netcode.md +165 -0
  271. package/dist/skills/opengame-performance/SKILL.md +106 -65
  272. package/dist/skills/opengame-performance/helpers/landing-pacer.mjs +86 -0
  273. package/dist/skills/opengame-performance/references/measuring.md +51 -0
  274. package/dist/skills/opengame-performance/references/webgpu.md +86 -0
  275. package/dist/skills/opengame-production/SKILL.md +119 -54
  276. package/dist/skills/opengame-production/references/team.md +107 -0
  277. package/dist/skills/opengame-production/references/templates.md +106 -16
  278. package/dist/skills/opengame-quality-bar/SKILL.md +94 -42
  279. package/dist/skills/opengame-quality-bar/references/cheap-tells.md +14 -7
  280. package/dist/skills/opengame-quality-bar/references/judges.md +95 -0
  281. package/dist/skills/opengame-quality-bar/references/review-prompt.md +10 -5
  282. package/dist/skills/opengame-rhythm/SKILL.md +138 -0
  283. package/dist/skills/opengame-rhythm/references/charting.md +109 -0
  284. package/dist/skills/opengame-rhythm/references/timing.md +92 -0
  285. package/dist/skills/opengame-router/SKILL.md +10 -2
  286. package/dist/skills/opengame-scene-audit/SKILL.md +64 -47
  287. package/dist/skills/opengame-scene-audit/helpers/scene-audit.js +97 -19
  288. package/dist/skills/opengame-sdk/SKILL.md +26 -9
  289. package/dist/skills/opengame-sdk/references/engines.md +2 -2
  290. package/dist/skills/opengame-sdk/references/identity.md +10 -11
  291. package/dist/skills/opengame-stability/SKILL.md +59 -27
  292. package/dist/skills/opengame-trailer-make/SKILL.md +164 -0
  293. package/dist/skills/opengame-trailer-make/references/archetypes.md +113 -0
  294. package/dist/skills/opengame-trailer-make/references/briefs.md +273 -0
  295. package/dist/skills/opengame-trailer-make/references/core.md +129 -0
  296. package/dist/skills/opengame-trailer-make/references/craft.md +299 -0
  297. package/dist/skills/opengame-trailer-make/references/edge-cases.md +27 -0
  298. package/dist/skills/opengame-trailer-make/references/filmable.md +244 -0
  299. package/dist/skills/opengame-trailer-make/references/finishing.md +126 -0
  300. package/dist/skills/opengame-trailer-make/references/gates.md +184 -0
  301. package/dist/skills/opengame-trailer-make/references/measure.md +282 -0
  302. package/dist/skills/opengame-trailer-make/references/music.md +148 -0
  303. package/dist/skills/opengame-trailer-make/references/og-clash-record.md +133 -0
  304. package/dist/skills/opengame-trailer-make/references/ops.md +154 -0
  305. package/dist/skills/opengame-trailer-make/references/owner-eye.md +214 -0
  306. package/dist/skills/opengame-trailer-make/references/review.md +141 -0
  307. package/dist/skills/opengame-trailer-make/references/title.md +92 -0
  308. package/dist/skills/opengame-trailer-plan/SKILL.md +176 -0
  309. package/dist/skills/opengame-trailer-plan/references/archetypes.md +113 -0
  310. package/dist/skills/opengame-trailer-plan/references/briefs.md +273 -0
  311. package/dist/skills/opengame-trailer-plan/references/core.md +129 -0
  312. package/dist/skills/opengame-trailer-plan/references/craft.md +299 -0
  313. package/dist/skills/opengame-trailer-plan/references/edge-cases.md +27 -0
  314. package/dist/skills/opengame-trailer-plan/references/filmable.md +244 -0
  315. package/dist/skills/opengame-trailer-plan/references/finishing.md +126 -0
  316. package/dist/skills/opengame-trailer-plan/references/gates.md +184 -0
  317. package/dist/skills/opengame-trailer-plan/references/measure.md +282 -0
  318. package/dist/skills/opengame-trailer-plan/references/music.md +148 -0
  319. package/dist/skills/opengame-trailer-plan/references/og-clash-record.md +133 -0
  320. package/dist/skills/opengame-trailer-plan/references/ops.md +154 -0
  321. package/dist/skills/opengame-trailer-plan/references/owner-eye.md +214 -0
  322. package/dist/skills/opengame-trailer-plan/references/reference-set.md +92 -0
  323. package/dist/skills/opengame-trailer-plan/references/review.md +141 -0
  324. package/dist/skills/opengame-trailer-plan/references/title.md +92 -0
  325. package/dist/skills/opengame-trailer-review-and-improve/SKILL.md +145 -0
  326. package/dist/skills/opengame-trailer-review-and-improve/references/archetypes.md +113 -0
  327. package/dist/skills/opengame-trailer-review-and-improve/references/briefs.md +273 -0
  328. package/dist/skills/opengame-trailer-review-and-improve/references/core.md +129 -0
  329. package/dist/skills/opengame-trailer-review-and-improve/references/craft.md +299 -0
  330. package/dist/skills/opengame-trailer-review-and-improve/references/edge-cases.md +27 -0
  331. package/dist/skills/opengame-trailer-review-and-improve/references/filmable.md +244 -0
  332. package/dist/skills/opengame-trailer-review-and-improve/references/finishing.md +126 -0
  333. package/dist/skills/opengame-trailer-review-and-improve/references/gates.md +184 -0
  334. package/dist/skills/opengame-trailer-review-and-improve/references/measure.md +282 -0
  335. package/dist/skills/opengame-trailer-review-and-improve/references/music.md +148 -0
  336. package/dist/skills/opengame-trailer-review-and-improve/references/og-clash-record.md +133 -0
  337. package/dist/skills/opengame-trailer-review-and-improve/references/ops.md +154 -0
  338. package/dist/skills/opengame-trailer-review-and-improve/references/owner-eye.md +214 -0
  339. package/dist/skills/opengame-trailer-review-and-improve/references/review.md +141 -0
  340. package/dist/skills/opengame-trailer-review-and-improve/references/title.md +92 -0
  341. package/dist/skills/opengame-verification/SKILL.md +113 -48
  342. package/dist/skills/opengame-weapons/SKILL.md +129 -55
  343. package/dist/skills/opengame-weapons/references/handling-numbers.md +42 -0
  344. package/dist/skills/opengame-weapons/references/reloads-and-hands.md +96 -0
  345. package/dist/skills/opengame-weapons/references/sights-and-scopes.md +98 -0
  346. package/dist/skills/opengame-weapons/references/threejs.md +71 -0
  347. package/dist/skills/opengame-world-physics/SKILL.md +55 -24
  348. package/dist/skills/opengame-world-physics/references/measured-failures.md +28 -1
  349. package/package.json +1 -1
@@ -1,8 +1,8 @@
1
1
  ---
2
2
  name: opengame-characters
3
- description: Bring generated or imported 3D characters into a browser game so they hold up in play. Covers skin checks against pinched waists, eased gait choice against third-person jitter, authored locomotion over procedural, thumb-and-mitten hands on the posed gun, canon sheets against drift, instant customisation, gated stages and real grips. Use when the character T-poses, jitters, bends wrong, feet slide, hands clip the gun, it drifts from the art, customising is slow, or a game shows the player's OG.
3
+ description: Bring generated or imported 3D characters into a browser game so they hold up in play. Covers clips audited on each figure's own rig, a first-person body never see-through, captured motion with IK only for contact, natural joint bands, holds from photographs, generated people, eased gaits and planted feet, mitten hands, canon sheets, instant customisation and the OG spec. Use when a character T-poses, tears, jitters, bends wrong, slides, clips the gun, drifts from the art, or shows an OG.
4
4
  metadata:
5
- version: "1.1.0"
5
+ version: "1.2.1"
6
6
  ---
7
7
 
8
8
  # Characters
@@ -10,19 +10,65 @@ metadata:
10
10
  A character is finished when it is right in the live spawn path, from the gameplay
11
11
  camera, while moving, including from behind. A model that loads, a rig that binds and
12
12
  a clip that plays are three separate facts, and none of them proves the visible
13
- character is correct.
13
+ character is correct. LC's owner raised the player's body, hands and holds more than
14
+ anything else, about 19 times; solver-posed arms were rejected three times in 17 hours,
15
+ and a joint check that read "0 faults" passed wrists the owner called inhuman.
14
16
 
15
17
  Rules carry five tags; `opengame-quality-bar` explains them and the game codes.
16
- Generation and Meshy specifics are in `opengame-assets`.
18
+ Generation and Meshy specifics are in `opengame-assets`. LC's first-person body, joint
19
+ limits and generated-people numbers are in
20
+ [references/first-person-body.md](references/first-person-body.md).
17
21
 
18
22
  ## Rules
19
23
 
20
- ### Bodies keep their volume in every clip
21
- - **Invariant:** No character or creature pinches, hourglasses, splits or bends wrong at the waist, hips, shoulders or neck in any clip, and this is checked when the asset is imported and again in motion.
22
- - **Technique:** At import, pose every clip offline and measure the posed waist width against the bind waist. Check that no thigh weight reaches above the hip or crosses to the other leg, that hoods and collars are not weighted into the head, that skirts and aprons follow the hips, that normals agree with face winding, and that left and right parts match. Spread twist over several torso bones. Then watch a turntable of every clip, because the numbers pass before the eye does.
23
- - **Reference configuration:** OC passes a waist at 0.95 or more of rest, and below 0.90 is a visible pinch. Two zombie types sat at 0.81 and 0.79; after reweighting all 20 heroes reached 0.957 or more and the zombies 0.97 to 0.99. A bind waist at 63 to 65% of hip depth reads as an hourglass even with good weights. One waist kept 65% of its width before the fix and 98% after; an apron weighted to the thighs filled the gap between the legs; a hook was weighted to the thigh instead of the hand; one shoe was 27% longer than its pair. The owner sent three messages in about 30 minutes ("we cant have that on any character or creature!"), and the defect was declared fixed by numbers while screenshots still showed it.
24
- - **Applies when:** Every skinned character or creature, generated or bought.
25
- - **Verify:** The import report lists the waist ratio per clip for every body, and a turntable of each clip in play shows no pinch.
24
+ ### Bodies keep their volume and their surface in every clip, on their own rig
25
+ - **Invariant:** No character or creature pinches, hourglasses, splits, tears or bends wrong at the waist, hips, shoulders or neck in any clip at any level of detail, every clip plays on the rig it was made or captured for, and this is checked when the asset is imported and again in motion.
26
+ - **Technique:** Auto-rig each generated figure and play library actions on that rig rather than retargeting onto a shared one. At import, pose every figure, clip and frame offline with the game's own skinning: measure the posed waist width against the bind waist, and count edges stretched or squeezed past a limit, listing failing clips and never playing them. Check that no thigh weight reaches above the hip or crosses to the other leg, that hoods and collars are not weighted into the head, that skirts and aprons follow the hips, that normals agree with face winding, and that left and right parts match. Spread twist over several torso bones. Then watch a turntable of every clip, because the numbers pass before the eye does.
27
+ - **Reference configuration:** OC passes a waist at 0.95 or more of rest, and below 0.90 is a visible pinch. Two zombie types sat at 0.81 and 0.79; after reweighting all 20 heroes reached 0.957 or more and the zombies 0.97 to 0.99. A bind waist at 63 to 65% of hip depth reads as an hourglass even with good weights. One waist kept 65% of its width before the fix and 98% after; an apron weighted to the thighs filled the gap between the legs; a hook was weighted to the thigh instead of the hand; one shoe was 27% longer than its pair. The owner sent three messages in about 30 minutes ("we cant have that on any character or creature!"), and the defect was declared fixed by numbers while screenshots still showed it. LC's shared rig with retargeted clips "failed every clip: 2 to 17% of the surface strained and edges pulled 40 to 150 times. That is what the owner saw." On each figure's own rig 572 of 572 clips passed, where torn means an edge over 3x or under 0.25x its bind length and a clip fails above 1% torn at any level of detail. Dual quaternion skinning measured worse (5.1% strained against 4.0%).
28
+ - **Applies when:** Every skinned character or creature, generated or bought, with a motion library.
29
+ - **Verify:** The import report lists the waist ratio and torn share per clip for every body, worst-frame sheets are opened large, and a turntable of each clip in play shows no pinch.
30
+
31
+ ### A generated body is measured against a human before it is animated
32
+ - **Invariant:** Every generated figure has human proportions at the size it fills the player's screen, a crowd's statures vary, and no weight stretches an edge past a limit over a joint's range.
33
+ - **Technique:** Print a proportions sheet per figure (stature, head, arm, upper arm against forearm, hand, wrist) and fix it before rigging. Vary stature across a crowd. Weight by a diffused field over a welded shell rather than by distance from the bone, and gate edge stretch per joint over its whole range. Judge figures in the game's light at arm's length.
34
+ - **Reference configuration:** LC's owner: "the characters and their meshes and zomebis are all fucked up and like dismorph and the way joins turn not all [photorealistic". Every zombie had stood exactly 1.80 m with heads 25 to 35% too big, the other soldier's arm was 26.1% of his height (a man's is 33.4%), and the hands were "0.132 x 0.075 m against a man's 0.095 x 0.03". After: stature 1.64 to 1.90 m, head 0.135 to 0.145 of height, arm 33%, upper arm 1.2x the forearm, wrist 0.55 of the forearm's width; edges over 2x at the hip went from 116 to 0, after "three rules by distance from the bone failed". OC's canon doc said 2.2 heads tall while its measured turnaround was 2.7 (below).
35
+ - **Applies when:** Every game using generated or bought humanoids. Stylised characters measure against their own canon sheet instead.
36
+ - **Verify:** The proportions sheet and worst-edge list per figure, and a lit sheet at arm's length.
37
+
38
+ ### Generated people are ordered for skinning, prepared, then rigged
39
+ - **Invariant:** Generated human figures arrive in a pose and outfit that rigging can handle, are reduced with their faces and hands intact, and are rigged only after that preparation, on the mesh the game ships.
40
+ - **Technique:** Ask for an A-pose with the arms held well out from the body, in close-fitting clothes, and look at the picture before paying for the mesh. Re-bake to a target triangle count with the head and hands dense, the head on its own texture sheet and its own reduction budget, and one unwrap shared by every level of detail. Rig the prepared mesh, never the raw one, and refuse a mesh that drifts from its rig's mesh. Long coats and capes fail on automatic rigs: avoid them or rig them by hand. Spend only with the person's own account and their yes on the cost (`opengame-assets`).
41
+ - **Reference configuration:** LC's dead cost about $2.44 to $2.66 a person with 27 actions: an A-pose concept, image-to-3D at 600k to 1M triangles, re-baked to about 11,500 (head share 0.27, hands 0.13) with levels at about 3,900 and 1,200 to 1,700, colour, normal and roughness at 2048, 2048 and 1024, and the head on its own 1024 sheet ("collapsing 700k triangles to 12k drags the texture across the raw atlas's seams"); the packer refuses a mesh more than 10 mm off its rig's mesh. One face had 18 triangles where it needed 400 ("the collapse spends the head's share on its curls"). OS gave its 52 generated OGs three levels of detail with an attribute-aware simplifier, since UV seams had locked plain simplification near 9k triangles.
42
+ - **Applies when:** Games using image-to-3D or text-to-3D humans.
43
+ - **Verify:** Every head sheet opened after preparation, and the deformation audit above passing on every clip.
44
+
45
+ ### The player's own body is never see-through
46
+ - **Invariant:** Every drawn part of the first-person body, clothing, gloves and weapon is opaque and whole at every reachable view angle.
47
+ - **Technique:** Keep parts away from the lens by pose, never by cutting geometry near the camera. Use a small near plane and no alpha test, dissolve, dither or near-fade on the player's own materials; make cloth closed and double-sided. Hide whole pieces (head, neck), never triangles. Keep post effects off anything very close to the lens. Hide the third-person body rather than shrink it. When something looks wrong close up, check whether the camera is inside a part.
48
+ - **Reference configuration:** LC's owner: "u shouldnt be ablet o see through ur body parts..." with two screenshots. A near-lens cut on every operator material dropped geometry within 7 to 20 cm of the lens, which sits on the chest, so the torso became a ring of ragged shards around a hole and the sleeves blades. After: a near plane of about 2.5 cm, post effects that skip anything within 1.2 m of the lens, and a playtest that saw no see-through frame at any angle. A "pale lining" on a sleeve was the camera inside the sleeve for 67% of the picture. OC's shrunken first-person head and arms spread white shards under the camera (below).
49
+ - **Applies when:** First person with a visible body.
50
+ - **Verify:** Scripted looks down, left, right and up, aiming, reloading and sprinting; a mask of the player's own materials fails on any alpha below 1.
51
+
52
+ ### Captured motion drives the body, and IK only makes contact
53
+ - **Invariant:** A first-person or armed body moves from captured motion on a whole rigged body; solvers only close hands and feet onto what they touch; and when a target cannot be reached within the joint limits, the held object moves, never the anatomy.
54
+ - **Technique:** Rig a whole body (legs, trunk, arms) with a third-person debug view, even when the player sees only arms. Drive stance, gait and reloads from captured clips blended by speed and gait, turn the chest to the aim, and let IK finish the grip with the elbow placed a set share of the way from hanging toward the captured elbow. Never solve an arm by the shortest arc from rest; give the forearm twist joints so it carries part of the hand's roll. Fix a bent wrist by moving the elbow, not the hand. Pick library clips from previews, not their names.
55
+ - **Reference configuration:** LC's owner: "why are the hands bent and look so fucking weird ... u also should have a body not just floating arms and hands... with legs body etc." Solver-only holds were rejected three times in 17 hours, and the rule written after the second was "motion capture drives the body, the solver only finishes the hands". Its operator has 22 joints and 32 captured clips, with two-bone arm IK and the elbow a third of the way from hanging toward the captured elbow: "the weapon moves, never the anatomy". Shortest-arc solves had wrung the forearm 36 degrees at the ready, 61 on the sights and 105 at one support elbow; ten twist joints per sleeve, the forearm carrying 0.6 of the hand's roll, took ring twist from 24 to 12 degrees. Five hand placements left a wrist at 23 to 44 degrees; moving the elbow under it gave 9 to 22. OS: a clip named "Chest Pound Taunt" was a sword taunt.
56
+ - **Applies when:** First-person arms and bodies, and any armed character.
57
+ - **Verify:** A third-person film of every weapon and state beside reference photographs, and the joint sweep in the next rule.
58
+
59
+ ### Joints stay inside natural bands, checked in the build
60
+ - **Invariant:** Wrists, elbows, shoulders and knees stay inside human limits on every frame of every hold, action and change between two, and inside a narrower natural band at rest and on the sights; a frame that leaves either raises an error in the build.
61
+ - **Technique:** Give every visible joint two gates, the impossible limit and a natural band for rest and aim, and check both per frame in the running build with a console error. Sweep every weapon and state while the joints are visible. Bound the natural, not only the impossible: a hold that passes "possible" can still read as wrong. Measure on the game's own rig.
62
+ - **Reference configuration:** LC's limits were a wrist about 70 degrees back, 80 forward and 20 to 30 to the side, later flexion 80, extension 70, radial 25, ulnar 40 and twist 85; the natural band is 20 degrees either way at rest and on the sights. Its check read "0 joint faults over 1,825 arm-states" and a playtest called it fixed, then the owner: "hands also still look fucked up holding the gun and pistol both hands just are angled not photorealistic and humanly". Wrists at 67 to 78 degrees had passed the first check's limit near 95, and the natural band came too late. Later, "when u ads and move aronud ur elbow and forearm like swivle out randomly ... u cant have weird angles of hands or arms etc anywhere"; one wrist's side-bend went from 51 to 22 degrees after about ten mends. A forearm twist weight of 0.5 (0.65 left a ring at the cuff) and a wrist cross-section never under 0.85 of rest kept the cuff whole.
63
+ - **Applies when:** First-person arms, and any armed or close-up character.
64
+ - **Verify:** A sweep of every weapon and state with a per-joint table against both gates, and a third-person film.
65
+
66
+ ### Holds are copied from photographs of trained people
67
+ - **Invariant:** How a character holds, aims, moves with and reloads a weapon or tool is copied from photographs and footage of trained people doing it, with one grip and one elbow place per hold, never invented or taken from generated pictures.
68
+ - **Technique:** Collect real photographs per weapon class and stance (rest, ready, aim, reload) before posing, and pose beside them. Use generated pictures for mood only. Keep one grip and one elbow place per hold, so the grip does not shift as the look moves. Set handedness once. Begin and end every action with a hand travelling, eased, so nothing appears or vanishes. Judge from the player's own picture at speed.
69
+ - **Reference configuration:** LC's first owner screenshot was a crop of the director's own composite, praised ten minutes earlier: a glove splayed flat on top of the fore-end, no firing hand, no shoulder. The owner: "thats nt how someone holds a gun this looks very unnatural and how u hold it and move wiht it and zoom in and out and all that stuff needs to be perfect and look photorealistic and how a real soldier would hold". Then "how come as u look further down where u grip the gun changes?.." (one grip per hold since), and "rn the gun is pointed from left to right idle i think it should be opposite to be realistic no?" (right-handed, the firing forearm from the lower right). A reload where the arm "randomly goes away" became a hand travel of about a third of a second in and out, and that pistol reload was the one explicit acceptance in the record. A library of eight grip poses arrived at the end and went unused.
70
+ - **Applies when:** Any character that holds a weapon or tool, in first or third person.
71
+ - **Verify:** A sheet per weapon class, photograph beside build at the same angle, at rest, ready, aimed and mid-reload.
26
72
 
27
73
  ### No pose weight ever changes in one frame
28
74
  - **Invariant:** Gait choice, direction switches and layer weights ease over time, so a third-person body never pops, flips or jitters while running, strafing, stopping or idling.
@@ -33,16 +79,23 @@ Generation and Meshy specifics are in `opengame-assets`.
33
79
 
34
80
  ### Locomotion is authored; procedural motion is a small layer
35
81
  - **Invariant:** Walking, running, idling and actions come from authored or captured clips blended by speed, with feet planted and legs still at idle; procedural passes add small corrections on top and never replace a limb's pose.
36
- - **Technique:** Buy or capture a locomotion set before writing procedural legs or arms. Blend clips by measured speed with matched phase, set cadence from distance travelled, and fix bad channels in the clip data at the source. Audit each procedural pass by turning it off and comparing.
37
- - **Reference configuration:** OC: mocap clips at walk 1.4, jog 3.4, run 4.8 and sprint 6.2 m/s, crossfades of at least 0.15 s; 40 clips cost about $2.40. Cadence by distance (1.05 m per walking cycle) cut foot skate from 84% to 30%. The "mannequin arms" the owner disliked came from a procedural arm pass that pulled the arms level. A knee and foot channel swap was fixed in 11 clips at the source. The owner asked 7 to 10 times, including "not even moving and my characters legs are moving".
82
+ - **Technique:** Buy or capture a locomotion set before writing procedural legs or arms. Blend clips by measured speed with matched phase, set cadence from distance travelled, and fix bad channels in the clip data at the source. Audit each procedural pass by turning it off and comparing. Library clips fail on sight more often than not: pick and trim them from side and front contact sheets before they reach the game.
83
+ - **Reference configuration:** OC: mocap clips at walk 1.4, jog 3.4, run 4.8 and sprint 6.2 m/s, crossfades of at least 0.15 s; 40 clips cost about $2.40. Cadence by distance (1.05 m per walking cycle) cut foot skate from 84% to 30%. The "mannequin arms" the owner disliked came from a procedural arm pass that pulled the arms level. A knee and foot channel swap was fixed in 11 clips at the source. The owner asked 7 to 10 times, including "not even moving and my characters legs are moving". LC's library gave a knockdown that back-flips, a side-walk sliding 18 mm a frame, deaths that kneel or kick and a lunge that turns its back.
38
84
  - **Applies when:** Every walking character. A stylised procedural walk is a style choice, made once and checked against the concept.
39
85
  - **Verify:** Stand still, walk, run and sprint in play and record the feet: planted feet do not slide and idle legs do not move. Turn each procedural layer off and confirm the base clip already reads right.
40
86
 
87
+ ### Gaits blend by phase, and feet are planted by distance travelled
88
+ - **Invariant:** Feet do not slide or pop: transitions blend, a new gait starts where the old one's feet were, stride phase follows the ground covered, a planted foot stays put heel then toe, and steps match the ground at every speed and on slopes.
89
+ - **Technique:** Crossfade every transition, starting the new clip at the old clip's normalised phase. Advance stride phase by metres travelled over stride length, or set playback rate from displacement after collision divided by stride over clip length, clamped per clip. Lock a foot while its heel is down, then its toe; step a foot home when it is left far out; sample the ground ahead for the swinging foot. Scale a first-person figure so the camera height is its own. Pick the gait from measured motion relative to facing, not from the key pressed, and gate it against a table of how people walk.
90
+ - **Reference configuration:** SR and MC crossfade 0.14 to 0.16 s, ladders and mantles 0.22 to 0.30 s. Gait thresholds walk above 0.4 m/s and run above 6 m/s. DK varies each actor's idle speed (0.55 + (id % 7) * 0.04) so a horde never moves in lockstep. OC crossfades in at least 0.15 s at a matched phase and sets `timeScale` from velocity. LC's owner: "ur legs/feet positoin and hwo they move while u walk and run is very unnatural and not aaa". Its operator had slid planted feet 21 to 38 mm a frame walking, 66 to 130 sprinting and 255 mm in one frame stopping; after, under 5 mm a frame, heel first, 0.95 to 1.01 m steps at 2.9 a second, the figure scaled to 1.70 m. Its person table: knee 0 to 5 degrees at heel strike, about 15 loading, 60 in swing; hip bob 4 cm walking, 6 to 10 running.
91
+ - **Applies when:** Every walking character, including a first-person body seen looking down.
92
+ - **Verify:** Record feet against the ground at slow, normal and sprint speed, against a wall, on stairs and through a stop; per-frame slide stays under the game's bar while planted.
93
+
41
94
  ### Hands are a thumb and a mitten, fixed to the posed gun
42
- - **Invariant:** First-person and held-item hands are simple closed shapes that rig and pose easily, attach to the item's posed transform, never pass into it, and never cover the sight.
43
- - **Technique:** Model the hand as a thumb plus a single mitten body, cuff-wide, as one closed mesh, unless the game's style needs fingers. Parent it to the gun's posed transform, not the unposed one. Test penetration numerically per reload phase (`opengame-weapons` has the check) and keep sleeves from stretching to reach.
44
- - **Reference configuration:** The owner on OC: "basically a thumb and then a blob for hands ... It should be easier to then rig it and animate it with the guns versus having five fingers", and later "We don't need five fingers. If anything you just need a thumb". Before that it took 4 first-person passes and 5 glove redesigns. OC's sleeves are about 0.17 m across. A hold constant stretched sleeves 16%; a glove covered 35% of one gun's aimed centre.
45
- - **Applies when:** First-person games and any character holding tools, unless the art style calls for articulated fingers.
95
+ - **Invariant:** First-person and held-item hands are simple closed shapes that rig and pose easily, attach to the item's posed transform, never pass into it, and never cover the sight, unless the game's style needs fingers.
96
+ - **Technique:** Model the hand as a thumb plus a single mitten body, cuff-wide, as one closed mesh. Parent it to the gun's posed transform, not the unposed one. Test penetration numerically per reload phase (`opengame-weapons` has the check) and keep sleeves from stretching to reach. When the style is photoreal, build five-finger gloves and solve each finger onto the grip, which is the larger job.
97
+ - **Reference configuration:** The owner on OC: "basically a thumb and then a blob for hands ... It should be easier to then rig it and animate it with the guns versus having five fingers", and later "We don't need five fingers. If anything you just need a thumb". Before that it took 4 first-person passes and 5 glove redesigns. OC's sleeves are about 0.17 m across; a hold constant stretched them 16%; a glove covered 35% of one gun's aimed centre. OS's owner settled on "glvoe/mit style hands" after about 20 notes and 45 to 60 discarded finger builds, then ended the work: "im fine with the fists/hands view as is". LC's photoreal style needed scripted five-finger gloves and a finger solver held to 1.5 mm (`opengame-weapons`).
98
+ - **Applies when:** First-person games and any character holding tools.
46
99
  - **Verify:** Capture hip, aimed and every reload for each gun; measure penetration and the covered share of the aimed centre.
47
100
 
48
101
  ### One canon sheet per character stops drift
@@ -62,59 +115,59 @@ Generation and Meshy specifics are in `opengame-assets`.
62
115
  ### Gate every stage
63
116
  - **Invariant:** Each stage of a character (reference, mesh, remesh, rig, skin check, clips, sockets, play) is inspected and passed before the next one is paid for.
64
117
  - **Technique:** Keep a short stage list per character with the evidence for each: the reference image, a turntable of the mesh, the polygon count after remesh, a rest-pose capture of the rig, a stretch pose for skinning, each clip looped three times, each socket with its equipment, and a capture in play.
65
- - **Reference configuration:** ST gates characters this way, and MC found that two soldiers generated with identical parameters came back at different quality, so each one is checked rather than assumed.
118
+ - **Reference configuration:** ST gates characters this way, and MC found that two soldiers generated with identical parameters came back at different quality, so each one is checked rather than assumed. LC checked the concept picture before paying for each mesh and opened every head sheet after preparation.
66
119
  - **Applies when:** Every generated or imported rigged character.
67
120
  - **Verify:** The stage list has evidence for every stage of every character in the game.
68
121
 
69
122
  ### Pilot two bodies before making many
70
123
  - **Invariant:** The pipeline is proven on two anatomically different characters before it runs for the rest.
71
124
  - **Technique:** Pick the two most different bodies the game needs (a heavy and a slight one, a biped and a creature) and take both all the way to play first. Rigs from one generator are not interchangeable; budget a per-character solve for stances, grips and contact.
72
- - **Reference configuration:** ST pilots two before forty. MC found its generator's rigs were not interchangeable between soldiers and that stance correction was a third per-soldier solve.
125
+ - **Reference configuration:** ST pilots two before forty. MC found its generator's rigs were not interchangeable between soldiers and that stance correction was a third per-soldier solve. LC's own-rig audit was proven on 14 people and 405 clips before it covered 21 people and 572 clips.
73
126
  - **Applies when:** Any game with more than a couple of characters.
74
127
  - **Verify:** Both pilots pass every gate in play before a batch is started.
75
128
 
76
129
  ### No T-poses, no primitive stand-ins
77
130
  - **Invariant:** No character is ever seen in its bind pose, and nothing a character holds is a primitive.
78
- - **Technique:** Start every character in an idle clip before its first render; give held items their own models with grip markers. A missing clip falls back to idle, never to the bind pose.
79
- - **Reference configuration:** Our originals require a rig and at minimum idle, locomotion and the game's one signature action on every character mesh. ST's review fails a T-pose anywhere.
131
+ - **Technique:** Start every character in an idle clip before its first render; give held items their own models with grip markers. A missing clip falls back to idle, never to the bind pose. Raise an error in the build when a figure is seen in its rest pose.
132
+ - **Reference configuration:** Our originals require a rig and at minimum idle, locomotion and the game's one signature action on every character mesh. ST's review fails a T-pose anywhere. LC's owner saw its dead "just go t pose when they die"; its build now logs an error on any rest pose (`opengame-enemies`).
80
133
  - **Applies when:** Every game with characters.
81
- - **Verify:** Capture every character on its first visible frame after spawn and after a respawn.
134
+ - **Verify:** Capture every character on its first visible frame after spawn, after a respawn and after a death.
82
135
 
83
136
  ### One owner of movement
84
137
  - **Invariant:** The controller moves the character's root through the world; animation never moves it, so the body, the collision capsule and the equipment stay together.
85
- - **Technique:** Strip net horizontal travel from locomotion clips while keeping bob and sway, normalise rest height and forward once, and use a positive uniform scale on animated ancestors. Correct gait clips only, never actions, jumps or deaths.
86
- - **Reference configuration:** AW rebases the hips of its mocap; ST's `prepareLocomotionClip` removes travel and checks three loops for drift. SR's death clip moves the hips more than two metres, so SR samples it once to set a conservative bound and culling stays on.
138
+ - **Technique:** Strip net horizontal travel from locomotion clips while keeping bob and sway, normalise rest height and forward once, and use a positive uniform scale on animated ancestors. Correct gait clips only, never actions, jumps or deaths. Strip root motion from additive hit reactions too.
139
+ - **Reference configuration:** AW rebases the hips of its mocap; ST's `prepareLocomotionClip` removes travel and checks three loops for drift. SR's death clip moves the hips more than two metres, so SR samples it once to set a conservative bound and culling stays on. LC's additive hit clips carried up to 84 cm of root motion, so struck figures slid sideways and snapped back (`opengame-enemies`).
87
140
  - **Applies when:** Every animated character driven by a controller.
88
141
  - **Verify:** Loop each gait three times in place: no drift, no snap at the loop, no separation from the capsule.
89
142
 
90
- ### Gaits blend by phase and speed
91
- - **Invariant:** Feet do not slide or pop: transitions blend, a new gait starts where the old one's feet were, and playback speed matches ground speed.
92
- - **Technique:** Crossfade every transition, starting the new clip at the old clip's normalised phase. Set playback rate from displacement after collision, divided by stride over clip length, clamped per clip. Pick the gait from measured motion relative to facing, not from the key pressed.
93
- - **Reference configuration:** SR and MC crossfade 0.14 to 0.16 s, ladders and mantles 0.22 to 0.30 s. Gait thresholds walk above 0.4 m/s and run above 6 m/s. DK varies each actor's idle speed (0.55 + (id % 7) * 0.04) so a horde never moves in lockstep. OC crossfades in at least 0.15 s at a matched phase and sets `timeScale` from velocity.
94
- - **Applies when:** Every walking character.
95
- - **Verify:** Record feet against the ground at slow, normal and sprint speed, against a wall and on stairs; no foot moves while planted.
96
-
97
143
  ### Hands hold the real grip
98
144
  - **Invariant:** A held weapon or tool follows the animated body, both hands sit on its real grips through movement, aim, recoil and reload, and the shot leaves from its real muzzle.
99
- - **Technique:** Attach rigid equipment to a bone with the inverse of the bone's rest transform so it keeps its fitted pose. Author grip and muzzle markers on the actual model, animate a pivot rather than the frozen carry matrix, then solve each arm as a two-bone chain to its grip with a stable elbow pole, clamping unreachable targets rather than stretching.
100
- - **Reference configuration:** MC's weapon IK, AW's hand-on-weapon validator, SR's weapon mount and DK's gear attachment by inverse rest matrix. SR validated 540 hand-grip poses across four outfits and every weapon. OC's default IK pole gave a 52 degree elbow where 17 to 18 was the target, and its third-person gun canted left twice.
145
+ - **Technique:** Attach rigid equipment to a bone with the inverse of the bone's rest transform so it keeps its fitted pose. Author grip and muzzle markers on the actual model, animate a pivot rather than the frozen carry matrix, then close each arm onto its grip as a two-bone chain over the captured pose, with a stable elbow pole, inside the joint bands; when a grip is out of reach, move the weapon, never stretch the arm.
146
+ - **Reference configuration:** MC's weapon IK, AW's hand-on-weapon validator, SR's weapon mount and DK's gear attachment by inverse rest matrix. SR validated 540 hand-grip poses across four outfits and every weapon. OC's default IK pole gave a 52 degree elbow where 17 to 18 was the target, and its third-person gun canted left twice. LC's finger solve passes at 1.5 mm counted over every vertex on the game's own rig (`opengame-weapons`).
101
147
  - **Applies when:** Characters that hold things, in third person or in any view that shows them from outside.
102
148
  - **Verify:** Capture both palms against the grips at several aim angles and through a reload; muzzle flash and shot origin coincide.
103
149
 
104
- ### Judge from the gameplay camera
105
- - **Invariant:** A character is accepted on how it looks in play, from the camera the player uses, from every side the player sees.
106
- - **Technique:** Capture rest, movement, the signature action and its return, from the gameplay camera, including rear views, and compare against the concept at the same camera. Judge motion as a frame sequence, not a still.
107
- - **Reference configuration:** ST compares player-camera captures with the selected concept and sends actual pixels to an adversarial reviewer; SR's character review lists native shoulder-camera appearance as outstanding until it is seen in play. OC's third-person gun was "hidden behind the body in every follow view"; the owner asked to see the hold "in EVERY camera hangle".
150
+ ### Judge from the gameplay camera, and from every camera that sees the body
151
+ - **Invariant:** A character is accepted on how it looks in play, from the camera the player uses and from every side the player sees, including how other players see the same body doing the same action.
152
+ - **Technique:** Capture rest, movement, the signature action and its return, from the gameplay camera, including rear views, and compare against the concept at the same camera. For a player body, also film it from outside as a teammate or rival sees it, with every first-person action expressed in the body's own frame. Judge motion as a frame sequence at a quarter speed and then at speed, not as a still.
153
+ - **Reference configuration:** ST compares player-camera captures with the selected concept and sends actual pixels to an adversarial reviewer; SR's character review lists native shoulder-camera appearance as outstanding until it is seen in play. OC's third-person gun was "hidden behind the body in every follow view"; the owner asked to see the hold "in EVERY camera hangle". LC's owner: "continue making sure that multiplayer how u see other soldiers/players is perfect with whatever movement and animation they are doing should look like a real person"; its co-op friend is the player's own figure, whole.
108
154
  - **Applies when:** Every game with characters.
109
- - **Verify:** A reviewer with fresh context passes the captures, rear views included.
155
+ - **Verify:** A reviewer with fresh context passes the captures, rear and outside views included.
110
156
 
111
157
  ### Fair bodies and fair budgets
112
158
  - **Invariant:** Hitboxes are fair across characters, and every character fits the game's frame budget.
113
159
  - **Technique:** Normalise heights so a tall character is not easier to hit, keep the hit capsule independent of cosmetic equipment, set polygon counts before rigging, and share geometry and materials across instances. Clone skinned characters with `SkeletonUtils.clone` so each owns its bones.
114
- - **Reference configuration:** ST budgets 150k triangles per character and 30k per prop. MC sets a 22,000 target before rigging so its rig does not bind to a mesh that is later remeshed. SR's four outfits add 1,140 to 1,320 triangles each and one mesh per actor without changing the hit capsule.
160
+ - **Reference configuration:** ST budgets 150k triangles per character and 30k per prop. MC sets a 22,000 target before rigging so its rig does not bind to a mesh that is later remeshed. SR's four outfits add 1,140 to 1,320 triangles each and one mesh per actor without changing the hit capsule. LC's co-op friend is 28,994 triangles with levels of detail under 12 m and from 12 to 40 m.
115
161
  - **Applies when:** Games with several characters on screen, competitive games above all.
116
162
  - **Verify:** Read triangle counts and draw calls with the busiest crowd on screen; compare hit capsules across characters.
117
163
 
164
+ ### The OG identity spec outranks art feedback
165
+ - **Invariant:** Wherever a game draws OpenGame avatars, each keeps what the SDK's spec lists under "What makes it an OG" (a big head in its own colour, a face made of eyes, mittens with a thumb, the outfit as chosen), a player's SDK avatar replaces the default, a crowd is generated rather than taken from other players, and no art pass, judge or critic removes any of it.
166
+ - **Technique:** Vendor the SDK's model and spec unchanged with a provenance note, split the figure into rigid parts, and read recipes live (next rule). Put the spec in every brief and every judge's rubric. Measure the head's share through the real game lens at play size, not on the model. Seed generated crowd members per place, with a test that forbids the features the spec leaves out. Ease crowd members aside rather than culling them. The spec covers OGs only; it does not license restyling other characters to match.
167
+ - **Reference configuration:** OH: "also where did our OGs go?... the og sdk identity stuff characters [screenshot] we need to keep those", after judge-driven passes had added a mouth and brows and made the crowd faceless, seven passes before the spec reached them; one later pass removed the thumbs and the next restored them. "also default og color should be white not orange" and "when someone brings their og/avatar throuhg the opengame sdk ofc it should be their colors"; the white head took nine passes to land on plain white. OH's figure has 16 parts; a face test over 40 seeds x 20 members forbids mouths, noses, brows and beards in its generated crowd; a head built at 51% of height read at 41 to 44% through the lens, against the spec's about 40%; 12 to 16 members per place, where culling had once left 3 to 7. OS went the other way once: a concept agent forced white mittens on first-person gloves "to match the OG character canon" after its owner had called white blob hands slop.
168
+ - **Applies when:** Any game drawing OpenGame avatars, as the player's OG or as a crowd.
169
+ - **Verify:** The face test; three recipes at play size after every art pass; the head share as seen, and the members per side per place.
170
+
118
171
  ### The player's OG is theirs, read fresh and never kept
119
172
  - **Invariant:** A game that offers the player's OpenGame OG builds it from `og.player.avatar` each session, never stores it or anything built from it, asks for it or relays it to other players, falls back to its own default for anything missing or unknown, and shows the same OG as "Your OG" in every scene and point of view.
120
173
  - **Technique:** Remembering that the player picked "Your OG" is fine; the recipe is not. Read it through `watchAvatar` from `@opengamehq/sdk/avatar`, which names the parts with the shared layout (`readAvatar` does the same for one recipe); never split the recipe by position. Map each part through the game's own table with a default per part, and draw it to `AVATAR-SPEC.md` in the SDK package, or start from the SDK's Three.js example in `examples/avatar-threejs`. For a menu, a scoreboard or a 2D game, `portraitUrl(avatar)` gives the head as OpenGame draws it. Start building the model off the main thread as soon as the SDK names the player, under the loading screen, and import it only in menus. List "Your OG" first, labelled, equipped once loaded, removed after sign-out. Give first person separate sleeves and hands in the same colors as the third-person OG rather than a shrunken body, keep a shoulder camera's OG to one side, give every OG the same hitbox in competitive play, and light menus separately from the level. The recipe format, the portrait, the 21-joint contract, the page-bake pattern and each view's settings are in [references/player-og.md](references/player-og.md).
@@ -126,4 +179,6 @@ Generation and Meshy specifics are in `opengame-assets`.
126
179
 
127
180
  Meshy's rig skeleton, animation library and the traps MC hit integrating them are in
128
181
  `opengame-assets`. Root-motion, carry-frame, grip, skin-check, eased gait and customise-pool code sketches:
129
- [references/integration.md](references/integration.md).
182
+ [references/integration.md](references/integration.md). LC's chest-camera body, joint
183
+ limits, foot planting and generated-people pipeline:
184
+ [references/first-person-body.md](references/first-person-body.md).
@@ -0,0 +1,108 @@
1
+ # A first-person body, and generated people
2
+
3
+ LC's numbers for the rules on the player's body, captured motion, joint bands, foot
4
+ planting and generated people in `SKILL.md`. LC is a photoreal body-camera survival
5
+ shooter in three.js WebGPU: the lens sits on the player's chest, and the dead are
6
+ generated people. Its owner raised the body, hands and holds about 19 times. Measure your
7
+ own; a stylised game keeps the method and sets its own numbers.
8
+
9
+ ## The whole body
10
+
11
+ - A full rig even when the player sees only arms: 22 joints, legs, trunk and arms, with a
12
+ third-person debug view. Floating arms were the owner's first note ("u also should have
13
+ a body not just floating arms and hands... with legs body etc.").
14
+ - 32 captured clips blended by speed and gait. The chest turns to the aim; the hips are
15
+ set so the chest point is the lens; leg IK keeps the feet on the ground.
16
+ - Arms by two-bone IK over the captured pose, the elbow a third of the way from hanging
17
+ toward the captured elbow. "When a target cannot be reached within the limits the
18
+ weapon moves, never the anatomy."
19
+ - The figure is scaled to 1.70 m so the lens height is its own body's.
20
+ - The lens on the breastbone: 1.30 m standing, 1.105 crouch-walking, 0.895 crouched;
21
+ the shoulders 0.22 m behind it. Looking down bends the trunk at the hips and the lens
22
+ rides it. Placement and feel numbers are in `opengame-game-feel`.
23
+
24
+ ## Never see-through
25
+
26
+ - Near plane about 2.5 cm. No alpha test, dissolve, dither or near-fade on the player's
27
+ own materials; closed, double-sided cloth.
28
+ - Hide the head and neck whole. Never cut triangles near the lens: a cut of everything
29
+ within 7 to 20 cm turned the torso into a ring of shards.
30
+ - Post effects skip everything within 1.2 m of the lens.
31
+ - When something close up looks wrong, check whether the camera is inside it: a "pale
32
+ lining" was the inside of a sleeve filling 67% of the picture, and a "hole" in the
33
+ shoulder, mended three times as a hole, was unlit cloth.
34
+
35
+ ## Joint limits and the natural band
36
+
37
+ | Joint | Impossible beyond | Natural band at rest and aim |
38
+ |---|---|---|
39
+ | Wrist flexion | 80 degrees | within 20 either way |
40
+ | Wrist extension | 70 degrees | within 20 either way |
41
+ | Wrist radial / ulnar | 25 / 40 degrees | within 20 either way |
42
+ | Forearm twist | 85 degrees | |
43
+
44
+ Check both gates on every frame in the running build, with a console error: the limits
45
+ on every frame, the band at rest and on the sights. LC's reload bar used a simpler pair,
46
+ 70 degrees bent and 30 to the side, on top of these. LC's first
47
+ check bounded only the impossible: "0 joint faults over 1,825 arm-states" while wrists at
48
+ 67 to 78 degrees looked wrong to the owner.
49
+
50
+ - Fix a bent wrist by the elbow's place, not the hand's: five hand placements left 23 to
51
+ 44 degrees; the elbow under the wrist gave 9 to 22.
52
+ - No shortest-arc arm solves: they wrung the forearm 36 degrees at the ready, 61 on the
53
+ sights and 105 at one support elbow. Ten twist joints per sleeve, the forearm carrying
54
+ 0.6 of the hand's roll (at most 1.2 rad), faded in over 15 to 50 degrees of bend: ring
55
+ twist from 24 to 12 degrees. A plain hinge fix opened a hole at the shoulder.
56
+ - Forearm twist weight 0.5; 0.65 left a ring at 0.56 of the cuff's area. The sleeve's
57
+ cuff rides the twist bone, the glove's cuff the hand, and a wrist cross-section never
58
+ falls under 0.85 of rest.
59
+
60
+ ## Holds
61
+
62
+ - One grip and one elbow place per hold, so the grip never shifts as the look moves.
63
+ - Right-handed: the firing forearm enters from the lower right.
64
+ - Every action begins and ends with a hand travelling, about a third of a second in and
65
+ out, eased.
66
+ - Copy holds from photographs and footage of trained people. LC's first rejected hold was
67
+ built against a composite of its own renders.
68
+
69
+ ## Feet
70
+
71
+ - Stride phase advanced by metres travelled over stride length: walk 1.48 m per two
72
+ steps x the square root of the speed ratio; runs of 1.73, 1.99, 2.43 and 2.94 m at 2.2,
73
+ 2.7, 3.8 and 5.5 m/s.
74
+ - Lock a foot while its heel is down, then its toe. A foot left more than 20 cm out steps
75
+ home. A turn past 49 degrees is a stepping turn. Sample the ground ahead for the
76
+ swinging foot. Jump phase comes from vertical velocity, not a fixed clip.
77
+ - Gate against a person table at 60 Hz: planted slide under 5 mm a frame; knee 0 to 5
78
+ degrees at heel strike, about 15 loading, 60 in swing; hip bob 4 cm walking and 6 to 10
79
+ running. Before: 21 to 38 mm a frame walking, 66 to 130 sprinting, 255 mm in one frame
80
+ on a stop.
81
+
82
+ ## Proportions
83
+
84
+ A human table for generated figures, at arm's length in the game's light: stature 1.64
85
+ to 1.90 m, head 0.135 to 0.145 of height, arm 33% of height, upper arm 1.2x the forearm,
86
+ wrist 0.55 of the forearm's width. No edge stretched over 2.0 to 2.2x across a joint's
87
+ range (hip: 116 edges over 2x to 0), with weights from a diffused field over the welded
88
+ shell.
89
+
90
+ ## Generated people, step by step (about $2.66 a person)
91
+
92
+ 1. An A-pose concept in close-fitting clothes, arms held well out. Look at it before
93
+ paying for the mesh.
94
+ 2. Image-to-3D at 4K, 600k to 1M triangles.
95
+ 3. Prepare: re-bake to about 11,500 triangles (head share 0.27, hands 0.13), a new
96
+ unwrap on a smoothed copy, 2048 bakes, the head on its own 1024 sheet with its own
97
+ reduction budget.
98
+ 4. Levels of detail at about 3,900 and 1,200 to 1,700 triangles, on the same unwrap.
99
+ 5. Rig the prepared mesh, not the raw one.
100
+ 6. Play 27 library actions on each figure's own rig.
101
+ 7. A packer refuses a mesh more than 10 mm off its rig's mesh.
102
+ 8. Audit every clip (torn: an edge over 3x or under 0.25x rest; fail above 1% torn) and
103
+ list the failing ones out.
104
+
105
+ Results: 56 of 56 clips failed on a shared skeleton; 405 clips on 14 people, then 572 of
106
+ 572 on 21 people, passed on their own rigs. Long coats and capes failed on automatic
107
+ rigs. Library motion still fails on sight: film it from the side, at a quarter speed,
108
+ before keeping it.
@@ -15,7 +15,7 @@ import { watchAvatar } from '@opengamehq/sdk/avatar'
15
15
 
16
16
  await og.init()
17
17
  watchAvatar(og, avatar => {
18
- if (!avatar) return useDefaultCharacter() // guest, sharing off, preview, signed out
18
+ if (!avatar) return useDefaultCharacter() // guest, no OG made, preview, signed out
19
19
  prepareYourOg(avatar) // avatar.head, avatar.outfit (null: default body)
20
20
  })
21
21
  ```
@@ -2,7 +2,7 @@
2
2
  name: opengame-cli
3
3
  description: Drive the OpenGame command line tool from an agent. Covers installing it, signing in with the person, every command, JSON and JSONL output, exit codes, findings and how to retry. Use when the person mentions the opengame command, the OpenGame CLI, installing @opengamehq/cli, opengame login, check, dev, deploy, status, submit, releases, rollback, unpublish, restore, delete, details, achievements, handle, jam or token, or a command exited with an error you need to read.
4
4
  metadata:
5
- version: "1.8.3"
5
+ version: "1.8.4"
6
6
  ---
7
7
 
8
8
  # Use the OpenGame CLI
@@ -70,7 +70,7 @@ token in a command argument, a file in the project, a log or a reply.
70
70
  | `opengame status [dir]` | Show the latest deploy for this folder, with its findings. |
71
71
  | `opengame deployments [dir]` | List the linked game's deploys, newest first. |
72
72
  | `opengame open [dir]` | Open the linked game's private page. |
73
- | `opengame submit [dir]` | Send one release to review, and enter it in a jam with flags. A deploy goes to review by itself; a person enters the jam on the deploy's page. |
73
+ | `opengame submit [dir]` | Send a release to review that is not there yet. A ready deploy goes to review by itself, and the person confirms the details and enters the jam on the deploy's page; for a release already in review, jam flags are not used (`jam_answers_unused`). |
74
74
  | `opengame jams [slug]` | List open jams, or show one jam's tracks and flags. |
75
75
  | `opengame jam <withdraw\|reenter>` | Withdraw the linked game's jam entry, or put a withdrawn one back. |
76
76
  | `opengame releases [dir]` | List the linked game's releases: which is live, which were live before, and which can be made live again. |
@@ -101,7 +101,7 @@ release with `rollback: true` on the ones that can be made live again. Confirm w
101
101
  person which one they want, then run `opengame rollback <release> --yes --json` with the
102
102
  eight characters the list prints or the whole id. It changes what every player gets from
103
103
  their next load, so never run it without the person's go-ahead, and never to undo a
104
- refusal: a release that was never live goes through `opengame submit`. It needs a token
104
+ refusal: a release that was never live goes through review, which its deploy starts by itself. It needs a token
105
105
  with `read` or `deploy`, and `submit`, which `opengame login` gives. A refusal's `message`
106
106
  says why, for example the game is not live, or a release is being published right now. If
107
107
  it answers `host_failed`, run the same command again: the second run writes only the
@@ -123,7 +123,7 @@ first half happened; run the same command again.
123
123
  undone, so run it only when the person has asked for that game to be deleted, and pass the
124
124
  title they confirmed rather than reading it off the game yourself. Unpublishing is the
125
125
  reversible way to take a game down; offer it first. Delete works only with the `opengame
126
- login` token. `delete_refused` says why, for example a legal hold or a reviewer holding it.
126
+ login` token. `delete_refused` says why, for example a legal hold.
127
127
 
128
128
  ## Change a game's words, or the person's handle
129
129
 
@@ -1,8 +1,8 @@
1
1
  ---
2
2
  name: opengame-deploy
3
- description: Put a browser game online with OpenGame, the marketplace and game jam for browser games. Packages the game, checks it locally, uploads it to a private preview only the owner can play, reads and fixes findings, then submits one exact release for review. Use when the person says deploy my game, put it online, host it, share it, upload it, publish it, get me a link, make it playable for friends, or asks where to put a browser game or a Three.js game.
3
+ description: Put a browser game online with OpenGame, the marketplace and game jam for browser games. Packages the game, checks it locally, uploads it to a private preview only the owner can play, reads and fixes findings, then hands the creator the page where they confirm the details after review. Use when the person says deploy my game, put it online, host it, share it, upload it, publish it, get me a link, make it playable for friends, or asks where to put a browser game or a Three.js game.
4
4
  metadata:
5
- version: "1.1.2"
5
+ version: "1.1.6"
6
6
  ---
7
7
 
8
8
  # Deploy a browser game to OpenGame
@@ -14,7 +14,7 @@ Nothing is wrong with the game or the install: ask the person to run `opengame l
14
14
  run the command again. Do not reinstall or work around it.
15
15
 
16
16
  <!-- generated:procedure -->
17
- Deploy the creator's game to a private preview, give them its link, and submit it only when they ask. Read each command's result before you run the next one.
17
+ Deploy the creator's game to a private preview and give them its link. Review starts automatically, and the creator publishes the game on the deploy's page. Read each command's result before you run the next one.
18
18
 
19
19
  ## Install
20
20
 
@@ -37,6 +37,8 @@ Install the OpenGame skills for the agent you run in, from the game folder:
37
37
  opengame skills add .
38
38
  ```
39
39
 
40
+ That installs a starting set. `opengame skills list` names the rest; add one with `--skill <name>`, or `--skill opengame-all-in-one` for every skill as one.
41
+
40
42
  The CLI talks to `https://opengame.io`. Never put a token in a command argument, a file in the repository, a log or a reply. For CI, set `OPENGAME_TOKEN` or pipe the token with `--token-stdin`.
41
43
 
42
44
  ## Output
@@ -107,7 +109,7 @@ opengame init . --title "My game" --json
107
109
  opengame init . --title "Doom but blue" --kind mod --based-on "Doom" --json
108
110
  ```
109
111
 
110
- Do not ask the creator for a description or a genre before deploying. When you know them, pass `--description` (40 characters or more) and `--genre`; when you do not, init writes a placeholder description and a provisional genre, and the deploy prints its page, where the creator writes the description, chooses the genre and enters the jam. After the deploy you can set the description yourself with `opengame details --description "..." --json`. If the file already exists, leave `init` alone and edit the file.
112
+ Do not ask the creator for a description or a genre before deploying. When you know them, pass `--description` (40 characters or more) and `--genre`; when you do not, leave them out. Every field defaults to Auto: review writes the description and the genre from the game, and the creator accepts or changes them on the deploy's page, where they also enter the jam. After the deploy you can set the description yourself with `opengame details --description "..." --json`. If the file already exists, leave `init` alone and edit the file.
111
113
 
112
114
  For a game that already exists on OpenGame, in a new checkout, link the folder first so the deploy does not create a second game:
113
115
 
@@ -157,7 +159,7 @@ Each finding has a `fault`, a `certainty` and a `retry`:
157
159
  | `fault: game` | Read `evidence`, make the change in `fix`, then run the command in `verify`. |
158
160
  | `certainty: heuristic` | Check the evidence before you change working code. |
159
161
  | `fault: platform` | Leave the game as it is. Follow `retry`: `now` runs again, `later` waits `retryAfterSeconds`, `after-fix` and `never` mean waiting will not help, so read `fix`. |
160
- | `fault: unknown` | A person decides at review. Report it to the creator. |
162
+ | `fault: unknown` | Nothing to change. The playtest and the automatic review settle it. Report it to the creator. |
161
163
 
162
164
  A plain `deploy` resumes a saved upload, or starts a fresh one with an `upload_restarted` notice when the saved one can no longer finish. A deploy started with `--idempotency-key` exits 2 instead. Start a fresh one with a new key, or without the flag:
163
165
 
@@ -166,25 +168,33 @@ opengame deploy . \
166
168
  --idempotency-key <a new key> --json
167
169
  ```
168
170
 
169
- Before a large batch of deploys, run `opengame limits --json` for the upload limits and the allowance left on the account. If the same platform failure repeats, stop and give the creator the command, the error code and the evidence.
171
+ An account can begin 5 deploys in a rolling day, so fix what `opengame check` finds before you deploy again. Run `opengame limits --json` for the upload limits and the allowance left on the account. If the same platform failure repeats, stop and give the creator the command, the error code and the evidence.
170
172
 
171
- ## Submit only on request
173
+ ## Review and publishing
172
174
 
173
- A deploy makes a private preview that only the creator's account can open. `opengame submit` sends a release to review, and the game goes public once review approves it and it is published. Submit only when the creator asks, and send the exact `releaseId` they played.
175
+ Review starts automatically once a deploy is ready, so you submit no release. Review is automatic: it plays the game, then passes it or returns it with findings.
174
176
 
175
- ```bash
176
- opengame jams --json
177
- opengame submit --release <releaseId> --no-wait --json
178
- ```
177
+ When review passes, the release waits for the creator. `opengame status --json` shows `data.review.state: "awaiting_details"` and the deploy's page in `data.review.url`. Give the creator that link. Signed in, in their own browser, they confirm the title, description and genre, enter the jam with its track and the models they used, and publish. You cannot do this for them. Before they do, you can set the words with `opengame details --title "..." --description "..." --json`.
179
178
 
180
- OpenGame decides where submissions go, and a ready deploy goes to review by itself. When that is a jam, the creator usually enters it on the deploy's page (`data.deploymentUrl`). To enter it from here instead, read the form with `opengame jams <slug> --json` and pass the track, the models they used and any sponsor evidence as `--track`, `--models`, `--sponsor` and `--evidence-<sponsor>`. A missing answer exits 2 and names the flag. A decomp or a mod cannot enter a jam.
179
+ An update to a game that is already live is the exception. When the token that deployed it holds `submit`, as the `opengame login` token does, and nothing is owed (its details are written and the jam is not asking), it goes live as soon as it passes review, with no step on the page. When the creator asked only for a preview of an update to a live game, deploy with a token made in their settings with `deploy` alone, set as `OPENGAME_TOKEN`, so the release waits for them.
181
180
 
182
- When `data.state` is `needs_certification`, give the creator `data.certifyUrl`, which the CLI also prints as a `certify_required` notice. They certify in their own browser that they have the rights to the game. You cannot do it for them. Follow the review with:
181
+ `opengame submit` cannot take the confirmation step either. The release is already in review, so the server keeps that submission and prints a `jam_answers_unused` notice: the jam answers you passed were not used.
182
+
183
+ While Game Jam #1 runs, a new game goes on OpenGame only as a jam entry, up to 2 for each account. Mods and decomps publish outside the jam at any time and never enter it. When the jam cannot take a build, for example because the account already has 2 entries, the build is not sent to review, and the deploy's page explains why. [Enter a jam](https://docs.opengame.io/guides/jams) has the rules.
184
+
185
+ Follow the release to the end:
183
186
 
184
187
  ```bash
185
188
  opengame status --watch --json
186
189
  ```
187
190
 
191
+ | `data.review.state` | What to do |
192
+ | --- | --- |
193
+ | `review`, `playtesting`, `waiting` | Review is running. Watch again. |
194
+ | `awaiting_details`, `needs_certification` | Give the creator `data.review.url`. Watch again once they say they have published. |
195
+ | `publishing`, `published` | The game is going live. `data.submission.gameUrl` is its page. |
196
+ | `returned` | Read the findings, fix the game and deploy again. The new deploy is reviewed automatically. |
197
+
188
198
  ## What a game may do
189
199
 
190
200
  OpenGame hosts static browser exports. The build needs `index.html` at the root of its output folder.
@@ -195,9 +205,19 @@ The published game runs at `https://<label>.opengame.gg`, one origin per game, a
195
205
 
196
206
  A game may not take payments, use crypto, make players create an account or give an email address, show ads, or carry ad pixels or session recording. [Packaging](https://docs.opengame.io/guides/packaging) has every rule and every check.
197
207
 
208
+ ## Multiplayer
209
+
210
+ OpenGame runs no game server or rooms. A multiplayer game brings its own, through PeerJS or a server the creator runs, and OpenGame supplies the invite link:
211
+
212
+ - **Invites.** Share `og.invite.link(code)`, the game's page on opengame.io with `?join=CODE`, never the game's `opengame.gg` address. After `await og.init()`, a player with `og.invite.code` set opened an invite: join them to that lobby with no menu in between. Codes are 4 to 12 capitals and digits, or 22 characters of `A-Z a-z 0-9 _ -`; for any other code, and outside OpenGame, `link` returns `null`, so keep the code on screen too.
213
+ - **PeerJS.** Run the creator's PeerServer over `wss:` in place of the public `0.peerjs.com`, check `Origin` in front of it, and prefix peer ids with the game's name. Use STUN plus TURN, with TURN credentials issued by the creator's server and kept out of the bundle. When the host leaves, the next player takes over the same lobby id so shared links keep working.
214
+ - **Game servers.** `wss:` and `https:` only. Allow the game's exact origin, never a pattern on `opengame.gg`. Send a token in a header or the first socket message, not a cookie, and treat `og.player.id` as the player's claim.
215
+
216
+ [Multiplayer](https://docs.opengame.io/guides/multiplayer) has the code, the server settings and how to test a lobby with two browsers.
217
+
198
218
  ## Engines
199
219
 
200
- OpenGame supports games built with Three.js, Unity, Godot, Kaigen and WebAssembly, and static web builds from any JavaScript engine. `opengame check` and the server detect the engine from the build. Any other static browser export uploads as a custom build, under the same file, scan and runtime checks.
220
+ OpenGame supports games built with Three.js, Unity, Godot, Kaigen and WebAssembly, and static web builds from any JavaScript engine. `opengame check` and the server detect the engine from the build. Any other static browser export uploads as a custom build, under the same file and runtime checks.
201
221
 
202
222
  Run `opengame init . --engine <id>` to record an engine's export folder. `opengame help --json` lists the IDs, and `init` prints the export steps and the guide for the one you choose. The [engine overview](https://docs.opengame.io/engines/overview) links every engine page.
203
223
 
@@ -22,16 +22,17 @@ last line, and the last line is always a `result` or an `error`.
22
22
  | 4 | Rate limited | Wait `retryAfterSeconds` if the error has it, otherwise a few minutes, then run the same command once. Do not loop |
23
23
  | 5 | Our side failed, or a local file could not be read or written | The game is fine. Retry later; never change the game for this |
24
24
  | 6 | This CLI is too old for the server | Run `next`, which is `opengame upgrade`. Signed out, run `opengame login` first; it works on this version |
25
+ | 7 | `not_launched`: OpenGame is not open to this caller yet | The CLI has no login. Ask the person to run `opengame login`, then run the same command again. Do not reinstall or retry in a loop |
25
26
 
26
27
  ## A worked repair
27
28
 
28
29
  A game whose `index.html` loads `./Game.js` while the file on disk is `game.js`. It runs
29
30
  on the creator's Mac, because the Mac's file system ignores case, and is a missing file for every
30
- player. `opengame check . --json` printed, from a real run:
31
+ player. `opengame check . --json` prints:
31
32
 
32
33
  ```json
33
34
  {"type":"finding","finding":{"release":null,"check":"case-mismatch","checkVersion":"packaging@1","state":"failed","certainty":"certain","fault":"game","evidence":{"observed":"index.html line 1 asks for Game.js, but the file is game.js.","file":"index.html:1"},"fix":"macOS and Windows do not care about capitalisation. The servers that hand your game to a player do. So this loads on your machine and the file is missing for everybody else. Fix the reference or rename the file so the two match exactly.","verify":"opengame check, then opengame deploy","retry":"after-fix"}}
34
- {"type":"finding","finding":{"release":null,"check":"platform-engine","checkVersion":"packaging@1","evidence":{"observed":"Could not confirm Three.js in this build."},"state":"inconclusive","certainty":"heuristic","fault":"unknown","fix":"The build can proceed. A reviewer will confirm the engine before publication. Nothing has to change now; you can deploy as it is.","verify":"opengame deploy","retry":"never"}}
35
+ {"type":"finding","finding":{"release":null,"check":"platform-engine","checkVersion":"packaging@1","evidence":{"observed":"Browser compatibility needs a playtest."},"state":"inconclusive","certainty":"heuristic","fault":"unknown","fix":"Built with Three.js r170, from window.__THREE__ registration. Static browser exports from any engine, or none, go to review, where a playtest checks that this one runs. Every game must pass the same runtime and safety checks before publication. Nothing has to change now; you can deploy as it is.","verify":"opengame deploy","retry":"never"}}
35
36
  {"type":"error","code":"check_failed","message":"This build has blockers. Fix them, then run opengame check again.","exitCode":1,"retry":"after-fix"}
36
37
  ```
37
38
 
@@ -42,13 +43,13 @@ Reading it:
42
43
  (or rename the file), then run what `verify` says.
43
44
  2. The second finding is `inconclusive`, `heuristic` and `fault: "unknown"`, with
44
45
  `retry: "never"`. It does not block anything. Do not add a fake Three.js import to make
45
- it go away; a person confirms the engine.
46
+ it go away; the playtest in review checks that the game runs.
46
47
  3. After the fix, `opengame check . --json` ends in a `result` and exits 0.
47
48
 
48
49
  ## Findings that are ours
49
50
 
50
- A finding with `fault: "platform"`, or an error with exit code 5, means a scanner, the
51
- test machine, a moderation provider or storage failed. The CLI says so in plain words.
51
+ A finding with `fault: "platform"`, or an error with exit code 5, means the test machine,
52
+ review or storage failed. The CLI says so in plain words.
52
53
  Leave the game alone, wait `retryAfterSeconds` when the finding or error has it (a few
53
54
  minutes when it does not), and run the same command again. Rewriting a working game to satisfy a broken check is the failure this rule
54
55
  exists to prevent.