@opengamehq/skills 1.4.0 → 1.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (383) hide show
  1. package/CHANGELOG.md +36 -0
  2. package/README.md +12 -4
  3. package/dist/.claude-plugin/marketplace.json +26 -0
  4. package/dist/skills/manifest.json +1407 -143
  5. package/dist/skills/opengame-accessibility/CHANGELOG.md +4 -0
  6. package/dist/skills/opengame-accessibility/SKILL.md +48 -32
  7. package/dist/skills/opengame-all-in-one/CHANGELOG.md +25 -0
  8. package/dist/skills/opengame-all-in-one/SKILL.md +195 -0
  9. package/dist/skills/opengame-all-in-one/references/opengame-accessibility/README.md +102 -0
  10. package/dist/skills/opengame-all-in-one/references/opengame-api/README.md +108 -0
  11. package/dist/skills/opengame-all-in-one/references/opengame-assets/README.md +168 -0
  12. package/dist/skills/opengame-all-in-one/references/opengame-assets/references/pipeline.md +164 -0
  13. package/dist/skills/opengame-all-in-one/references/opengame-audio/README.md +238 -0
  14. package/dist/skills/opengame-all-in-one/references/opengame-audio/helpers/audio-chain.js +325 -0
  15. package/dist/skills/opengame-all-in-one/references/opengame-audio/references/mix-notes.md +125 -0
  16. package/dist/skills/opengame-all-in-one/references/opengame-audio/references/qa-without-ears.md +177 -0
  17. package/dist/skills/opengame-all-in-one/references/opengame-capture/README.md +128 -0
  18. package/dist/skills/opengame-all-in-one/references/opengame-capture/references/pipeline.md +114 -0
  19. package/dist/skills/opengame-all-in-one/references/opengame-capture/references/threejs.md +161 -0
  20. package/dist/skills/opengame-all-in-one/references/opengame-characters/README.md +180 -0
  21. package/dist/skills/opengame-all-in-one/references/opengame-characters/references/first-person-body.md +108 -0
  22. package/dist/skills/opengame-all-in-one/references/opengame-characters/references/integration.md +144 -0
  23. package/dist/skills/opengame-all-in-one/references/opengame-characters/references/player-og.md +160 -0
  24. package/dist/skills/opengame-all-in-one/references/opengame-cli/README.md +190 -0
  25. package/dist/skills/opengame-all-in-one/references/opengame-deploy/README.md +229 -0
  26. package/dist/skills/opengame-all-in-one/references/opengame-deploy/references/json-events.md +63 -0
  27. package/dist/skills/opengame-all-in-one/references/opengame-deploy/references/manifest.md +90 -0
  28. package/dist/skills/opengame-all-in-one/references/opengame-deploy/references/packaging.md +120 -0
  29. package/dist/skills/opengame-all-in-one/references/opengame-depth/README.md +154 -0
  30. package/dist/skills/opengame-all-in-one/references/opengame-enemies/README.md +155 -0
  31. package/dist/skills/opengame-all-in-one/references/opengame-enemies/references/pacing-and-bots.md +108 -0
  32. package/dist/skills/opengame-all-in-one/references/opengame-enemies/references/threejs.md +193 -0
  33. package/dist/skills/opengame-all-in-one/references/opengame-front-end/README.md +185 -0
  34. package/dist/skills/opengame-all-in-one/references/opengame-front-end/references/launch.md +50 -0
  35. package/dist/skills/opengame-all-in-one/references/opengame-front-end/references/menus.md +81 -0
  36. package/dist/skills/opengame-all-in-one/references/opengame-game-feel/README.md +181 -0
  37. package/dist/skills/opengame-all-in-one/references/opengame-game-feel/helpers/spring.js +146 -0
  38. package/dist/skills/opengame-all-in-one/references/opengame-game-feel/references/feel-numbers.md +142 -0
  39. package/dist/skills/opengame-all-in-one/references/opengame-game-feel/references/killcam.md +88 -0
  40. package/dist/skills/opengame-all-in-one/references/opengame-jam/README.md +121 -0
  41. package/dist/skills/opengame-all-in-one/references/opengame-lighting/README.md +141 -0
  42. package/dist/skills/opengame-all-in-one/references/opengame-lighting/helpers/light-pool.js +185 -0
  43. package/dist/skills/opengame-all-in-one/references/opengame-loading/README.md +135 -0
  44. package/dist/skills/opengame-all-in-one/references/opengame-loading/helpers/loading-count.mjs +115 -0
  45. package/dist/skills/opengame-all-in-one/references/opengame-loading/references/threejs.md +141 -0
  46. package/dist/skills/opengame-all-in-one/references/opengame-look/README.md +181 -0
  47. package/dist/skills/opengame-all-in-one/references/opengame-look/references/matching-a-reference.md +73 -0
  48. package/dist/skills/opengame-all-in-one/references/opengame-look/references/painterly.md +69 -0
  49. package/dist/skills/opengame-all-in-one/references/opengame-look/references/post-and-lens.md +73 -0
  50. package/dist/skills/opengame-all-in-one/references/opengame-maps/README.md +74 -0
  51. package/dist/skills/opengame-all-in-one/references/opengame-maps/references/map-spec.md +77 -0
  52. package/dist/skills/opengame-all-in-one/references/opengame-mobile/README.md +86 -0
  53. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/README.md +183 -0
  54. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/briefs.md +293 -0
  55. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/day-one-questions.md +46 -0
  56. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/edge-cases.md +27 -0
  57. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/filmable.md +244 -0
  58. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/finishing.md +126 -0
  59. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/measure.md +282 -0
  60. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-capture.md +151 -0
  61. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-gates.md +84 -0
  62. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-genres.md +198 -0
  63. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-grammar.md +320 -0
  64. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-ops.md +127 -0
  65. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/og-snipers-record.md +110 -0
  66. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/owner-eye.md +214 -0
  67. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/reference-study.md +293 -0
  68. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/song.md +64 -0
  69. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/README.md +193 -0
  70. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/briefs.md +293 -0
  71. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/day-one-questions.md +46 -0
  72. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/filmable.md +244 -0
  73. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/measure.md +282 -0
  74. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-capture.md +151 -0
  75. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-gates.md +84 -0
  76. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-genres.md +198 -0
  77. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-grammar.md +320 -0
  78. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-ops.md +127 -0
  79. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/og-snipers-record.md +110 -0
  80. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/owner-eye.md +214 -0
  81. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/reference-study.md +293 -0
  82. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/song.md +64 -0
  83. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/README.md +174 -0
  84. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/briefs.md +293 -0
  85. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/day-one-questions.md +46 -0
  86. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/filmable.md +244 -0
  87. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/finishing.md +126 -0
  88. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/measure.md +282 -0
  89. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-capture.md +151 -0
  90. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-gates.md +84 -0
  91. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-genres.md +198 -0
  92. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-grammar.md +320 -0
  93. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-ops.md +127 -0
  94. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/og-snipers-record.md +110 -0
  95. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/owner-eye.md +214 -0
  96. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/reference-study.md +293 -0
  97. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/song.md +64 -0
  98. package/dist/skills/opengame-all-in-one/references/opengame-multiplayer/README.md +139 -0
  99. package/dist/skills/opengame-all-in-one/references/opengame-multiplayer/references/bot-lobbies.md +71 -0
  100. package/dist/skills/opengame-all-in-one/references/opengame-multiplayer/references/netcode.md +165 -0
  101. package/dist/skills/opengame-all-in-one/references/opengame-performance/README.md +177 -0
  102. package/dist/skills/opengame-all-in-one/references/opengame-performance/helpers/landing-pacer.mjs +86 -0
  103. package/dist/skills/opengame-all-in-one/references/opengame-performance/references/measuring.md +123 -0
  104. package/dist/skills/opengame-all-in-one/references/opengame-performance/references/webgpu.md +86 -0
  105. package/dist/skills/opengame-all-in-one/references/opengame-production/README.md +192 -0
  106. package/dist/skills/opengame-all-in-one/references/opengame-production/references/team.md +107 -0
  107. package/dist/skills/opengame-all-in-one/references/opengame-production/references/templates.md +153 -0
  108. package/dist/skills/opengame-all-in-one/references/opengame-quality-bar/README.md +170 -0
  109. package/dist/skills/opengame-all-in-one/references/opengame-quality-bar/references/cheap-tells.md +43 -0
  110. package/dist/skills/opengame-all-in-one/references/opengame-quality-bar/references/judges.md +95 -0
  111. package/dist/skills/opengame-all-in-one/references/opengame-quality-bar/references/review-prompt.md +32 -0
  112. package/dist/skills/opengame-all-in-one/references/opengame-rhythm/README.md +134 -0
  113. package/dist/skills/opengame-all-in-one/references/opengame-rhythm/references/charting.md +109 -0
  114. package/dist/skills/opengame-all-in-one/references/opengame-rhythm/references/timing.md +92 -0
  115. package/dist/skills/opengame-all-in-one/references/opengame-router/README.md +54 -0
  116. package/dist/skills/opengame-all-in-one/references/opengame-router/references/process.md +38 -0
  117. package/dist/skills/opengame-all-in-one/references/opengame-scene-audit/README.md +136 -0
  118. package/dist/skills/opengame-all-in-one/references/opengame-scene-audit/helpers/scene-audit.js +677 -0
  119. package/dist/skills/opengame-all-in-one/references/opengame-sdk/README.md +283 -0
  120. package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/engines.md +93 -0
  121. package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/frame.md +107 -0
  122. package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/identity.md +111 -0
  123. package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/leaderboards.md +115 -0
  124. package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/radio.md +71 -0
  125. package/dist/skills/opengame-all-in-one/references/opengame-stability/README.md +112 -0
  126. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/README.md +160 -0
  127. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/archetypes.md +113 -0
  128. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/briefs.md +273 -0
  129. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/core.md +129 -0
  130. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/craft.md +299 -0
  131. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/edge-cases.md +27 -0
  132. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/filmable.md +244 -0
  133. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/finishing.md +126 -0
  134. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/gates.md +184 -0
  135. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/measure.md +282 -0
  136. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/music.md +148 -0
  137. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/og-clash-record.md +133 -0
  138. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/ops.md +154 -0
  139. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/owner-eye.md +214 -0
  140. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/review.md +141 -0
  141. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/title.md +92 -0
  142. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/README.md +172 -0
  143. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/archetypes.md +113 -0
  144. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/briefs.md +273 -0
  145. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/core.md +129 -0
  146. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/craft.md +299 -0
  147. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/edge-cases.md +27 -0
  148. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/filmable.md +244 -0
  149. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/finishing.md +126 -0
  150. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/gates.md +184 -0
  151. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/measure.md +282 -0
  152. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/music.md +148 -0
  153. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/og-clash-record.md +133 -0
  154. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/ops.md +154 -0
  155. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/owner-eye.md +214 -0
  156. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/reference-set.md +92 -0
  157. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/review.md +141 -0
  158. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/title.md +92 -0
  159. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/README.md +141 -0
  160. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/archetypes.md +113 -0
  161. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/briefs.md +273 -0
  162. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/core.md +129 -0
  163. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/craft.md +299 -0
  164. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/edge-cases.md +27 -0
  165. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/filmable.md +244 -0
  166. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/finishing.md +126 -0
  167. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/gates.md +184 -0
  168. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/measure.md +282 -0
  169. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/music.md +148 -0
  170. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/og-clash-record.md +133 -0
  171. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/ops.md +154 -0
  172. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/owner-eye.md +214 -0
  173. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/review.md +141 -0
  174. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/title.md +92 -0
  175. package/dist/skills/opengame-all-in-one/references/opengame-verification/README.md +197 -0
  176. package/dist/skills/opengame-all-in-one/references/opengame-verification/helpers/browser-evidence.mjs +74 -0
  177. package/dist/skills/opengame-all-in-one/references/opengame-weapons/README.md +179 -0
  178. package/dist/skills/opengame-all-in-one/references/opengame-weapons/references/handling-numbers.md +114 -0
  179. package/dist/skills/opengame-all-in-one/references/opengame-weapons/references/reloads-and-hands.md +96 -0
  180. package/dist/skills/opengame-all-in-one/references/opengame-weapons/references/sights-and-scopes.md +98 -0
  181. package/dist/skills/opengame-all-in-one/references/opengame-weapons/references/threejs.md +240 -0
  182. package/dist/skills/opengame-all-in-one/references/opengame-world-physics/README.md +141 -0
  183. package/dist/skills/opengame-all-in-one/references/opengame-world-physics/references/measured-failures.md +79 -0
  184. package/dist/skills/opengame-api/CHANGELOG.md +12 -0
  185. package/dist/skills/opengame-api/SKILL.md +40 -13
  186. package/dist/skills/opengame-assets/CHANGELOG.md +11 -0
  187. package/dist/skills/opengame-assets/SKILL.md +79 -31
  188. package/dist/skills/opengame-assets/references/pipeline.md +67 -0
  189. package/dist/skills/opengame-audio/CHANGELOG.md +11 -0
  190. package/dist/skills/opengame-audio/SKILL.md +129 -41
  191. package/dist/skills/opengame-audio/references/mix-notes.md +44 -1
  192. package/dist/skills/opengame-audio/references/qa-without-ears.md +177 -0
  193. package/dist/skills/opengame-capture/CHANGELOG.md +10 -0
  194. package/dist/skills/opengame-capture/SKILL.md +44 -20
  195. package/dist/skills/opengame-capture/references/pipeline.md +33 -1
  196. package/dist/skills/opengame-capture/references/threejs.md +17 -1
  197. package/dist/skills/opengame-characters/CHANGELOG.md +15 -0
  198. package/dist/skills/opengame-characters/SKILL.md +94 -39
  199. package/dist/skills/opengame-characters/references/first-person-body.md +108 -0
  200. package/dist/skills/opengame-characters/references/player-og.md +1 -1
  201. package/dist/skills/opengame-cli/CHANGELOG.md +16 -0
  202. package/dist/skills/opengame-cli/SKILL.md +13 -11
  203. package/dist/skills/opengame-deploy/CHANGELOG.md +24 -0
  204. package/dist/skills/opengame-deploy/SKILL.md +47 -21
  205. package/dist/skills/opengame-deploy/references/json-events.md +6 -5
  206. package/dist/skills/opengame-deploy/references/manifest.md +3 -2
  207. package/dist/skills/opengame-deploy/references/packaging.md +29 -26
  208. package/dist/skills/opengame-depth/CHANGELOG.md +8 -0
  209. package/dist/skills/opengame-depth/SKILL.md +61 -33
  210. package/dist/skills/opengame-enemies/CHANGELOG.md +10 -0
  211. package/dist/skills/opengame-enemies/SKILL.md +96 -40
  212. package/dist/skills/opengame-enemies/references/pacing-and-bots.md +108 -0
  213. package/dist/skills/opengame-enemies/references/threejs.md +59 -0
  214. package/dist/skills/opengame-front-end/CHANGELOG.md +4 -0
  215. package/dist/skills/opengame-front-end/SKILL.md +85 -39
  216. package/dist/skills/opengame-front-end/references/menus.md +42 -8
  217. package/dist/skills/opengame-game-feel/CHANGELOG.md +11 -0
  218. package/dist/skills/opengame-game-feel/SKILL.md +95 -47
  219. package/dist/skills/opengame-game-feel/references/feel-numbers.md +59 -0
  220. package/dist/skills/opengame-game-feel/references/killcam.md +88 -0
  221. package/dist/skills/opengame-jam/CHANGELOG.md +12 -0
  222. package/dist/skills/opengame-jam/SKILL.md +59 -37
  223. package/dist/skills/opengame-lighting/CHANGELOG.md +9 -0
  224. package/dist/skills/opengame-lighting/SKILL.md +85 -34
  225. package/dist/skills/opengame-loading/CHANGELOG.md +4 -0
  226. package/dist/skills/opengame-loading/SKILL.md +78 -38
  227. package/dist/skills/opengame-loading/helpers/loading-count.mjs +115 -0
  228. package/dist/skills/opengame-loading/references/threejs.md +32 -7
  229. package/dist/skills/opengame-look/CHANGELOG.md +9 -0
  230. package/dist/skills/opengame-look/SKILL.md +122 -51
  231. package/dist/skills/opengame-look/references/matching-a-reference.md +73 -0
  232. package/dist/skills/opengame-look/references/painterly.md +69 -0
  233. package/dist/skills/opengame-look/references/post-and-lens.md +10 -3
  234. package/dist/skills/opengame-maps/CHANGELOG.md +9 -0
  235. package/dist/skills/opengame-maps/SKILL.md +78 -0
  236. package/dist/skills/opengame-maps/references/map-spec.md +77 -0
  237. package/dist/skills/opengame-mobile/CHANGELOG.md +4 -0
  238. package/dist/skills/opengame-mobile/SKILL.md +18 -18
  239. package/dist/skills/opengame-montage-make/CHANGELOG.md +5 -0
  240. package/dist/skills/opengame-montage-make/SKILL.md +187 -0
  241. package/dist/skills/opengame-montage-make/references/briefs.md +293 -0
  242. package/dist/skills/opengame-montage-make/references/day-one-questions.md +46 -0
  243. package/dist/skills/opengame-montage-make/references/edge-cases.md +27 -0
  244. package/dist/skills/opengame-montage-make/references/filmable.md +244 -0
  245. package/dist/skills/opengame-montage-make/references/finishing.md +126 -0
  246. package/dist/skills/opengame-montage-make/references/measure.md +282 -0
  247. package/dist/skills/opengame-montage-make/references/montage-capture.md +151 -0
  248. package/dist/skills/opengame-montage-make/references/montage-gates.md +84 -0
  249. package/dist/skills/opengame-montage-make/references/montage-genres.md +198 -0
  250. package/dist/skills/opengame-montage-make/references/montage-grammar.md +320 -0
  251. package/dist/skills/opengame-montage-make/references/montage-ops.md +127 -0
  252. package/dist/skills/opengame-montage-make/references/og-snipers-record.md +110 -0
  253. package/dist/skills/opengame-montage-make/references/owner-eye.md +214 -0
  254. package/dist/skills/opengame-montage-make/references/reference-study.md +293 -0
  255. package/dist/skills/opengame-montage-make/references/song.md +64 -0
  256. package/dist/skills/opengame-montage-plan/CHANGELOG.md +5 -0
  257. package/dist/skills/opengame-montage-plan/SKILL.md +197 -0
  258. package/dist/skills/opengame-montage-plan/references/briefs.md +293 -0
  259. package/dist/skills/opengame-montage-plan/references/day-one-questions.md +46 -0
  260. package/dist/skills/opengame-montage-plan/references/filmable.md +244 -0
  261. package/dist/skills/opengame-montage-plan/references/measure.md +282 -0
  262. package/dist/skills/opengame-montage-plan/references/montage-capture.md +151 -0
  263. package/dist/skills/opengame-montage-plan/references/montage-gates.md +84 -0
  264. package/dist/skills/opengame-montage-plan/references/montage-genres.md +198 -0
  265. package/dist/skills/opengame-montage-plan/references/montage-grammar.md +320 -0
  266. package/dist/skills/opengame-montage-plan/references/montage-ops.md +127 -0
  267. package/dist/skills/opengame-montage-plan/references/og-snipers-record.md +110 -0
  268. package/dist/skills/opengame-montage-plan/references/owner-eye.md +214 -0
  269. package/dist/skills/opengame-montage-plan/references/reference-study.md +293 -0
  270. package/dist/skills/opengame-montage-plan/references/song.md +64 -0
  271. package/dist/skills/opengame-montage-review-and-improve/CHANGELOG.md +5 -0
  272. package/dist/skills/opengame-montage-review-and-improve/SKILL.md +178 -0
  273. package/dist/skills/opengame-montage-review-and-improve/references/briefs.md +293 -0
  274. package/dist/skills/opengame-montage-review-and-improve/references/day-one-questions.md +46 -0
  275. package/dist/skills/opengame-montage-review-and-improve/references/filmable.md +244 -0
  276. package/dist/skills/opengame-montage-review-and-improve/references/finishing.md +126 -0
  277. package/dist/skills/opengame-montage-review-and-improve/references/measure.md +282 -0
  278. package/dist/skills/opengame-montage-review-and-improve/references/montage-capture.md +151 -0
  279. package/dist/skills/opengame-montage-review-and-improve/references/montage-gates.md +84 -0
  280. package/dist/skills/opengame-montage-review-and-improve/references/montage-genres.md +198 -0
  281. package/dist/skills/opengame-montage-review-and-improve/references/montage-grammar.md +320 -0
  282. package/dist/skills/opengame-montage-review-and-improve/references/montage-ops.md +127 -0
  283. package/dist/skills/opengame-montage-review-and-improve/references/og-snipers-record.md +110 -0
  284. package/dist/skills/opengame-montage-review-and-improve/references/owner-eye.md +214 -0
  285. package/dist/skills/opengame-montage-review-and-improve/references/reference-study.md +293 -0
  286. package/dist/skills/opengame-montage-review-and-improve/references/song.md +64 -0
  287. package/dist/skills/opengame-multiplayer/CHANGELOG.md +15 -0
  288. package/dist/skills/opengame-multiplayer/SKILL.md +143 -0
  289. package/dist/skills/opengame-multiplayer/references/bot-lobbies.md +71 -0
  290. package/dist/skills/opengame-multiplayer/references/netcode.md +165 -0
  291. package/dist/skills/opengame-performance/CHANGELOG.md +8 -0
  292. package/dist/skills/opengame-performance/SKILL.md +106 -65
  293. package/dist/skills/opengame-performance/helpers/landing-pacer.mjs +86 -0
  294. package/dist/skills/opengame-performance/references/measuring.md +51 -0
  295. package/dist/skills/opengame-performance/references/webgpu.md +86 -0
  296. package/dist/skills/opengame-production/CHANGELOG.md +13 -0
  297. package/dist/skills/opengame-production/SKILL.md +119 -54
  298. package/dist/skills/opengame-production/references/team.md +107 -0
  299. package/dist/skills/opengame-production/references/templates.md +106 -16
  300. package/dist/skills/opengame-quality-bar/CHANGELOG.md +10 -0
  301. package/dist/skills/opengame-quality-bar/SKILL.md +94 -42
  302. package/dist/skills/opengame-quality-bar/references/cheap-tells.md +14 -7
  303. package/dist/skills/opengame-quality-bar/references/judges.md +95 -0
  304. package/dist/skills/opengame-quality-bar/references/review-prompt.md +10 -5
  305. package/dist/skills/opengame-rhythm/CHANGELOG.md +5 -0
  306. package/dist/skills/opengame-rhythm/SKILL.md +138 -0
  307. package/dist/skills/opengame-rhythm/references/charting.md +109 -0
  308. package/dist/skills/opengame-rhythm/references/timing.md +92 -0
  309. package/dist/skills/opengame-router/CHANGELOG.md +8 -0
  310. package/dist/skills/opengame-router/SKILL.md +14 -7
  311. package/dist/skills/opengame-scene-audit/CHANGELOG.md +15 -0
  312. package/dist/skills/opengame-scene-audit/SKILL.md +64 -47
  313. package/dist/skills/opengame-scene-audit/helpers/scene-audit.js +97 -19
  314. package/dist/skills/opengame-sdk/CHANGELOG.md +12 -0
  315. package/dist/skills/opengame-sdk/SKILL.md +26 -9
  316. package/dist/skills/opengame-sdk/references/engines.md +2 -2
  317. package/dist/skills/opengame-sdk/references/identity.md +10 -11
  318. package/dist/skills/opengame-stability/CHANGELOG.md +4 -0
  319. package/dist/skills/opengame-stability/SKILL.md +59 -27
  320. package/dist/skills/opengame-trailer-make/CHANGELOG.md +5 -0
  321. package/dist/skills/opengame-trailer-make/SKILL.md +164 -0
  322. package/dist/skills/opengame-trailer-make/references/archetypes.md +113 -0
  323. package/dist/skills/opengame-trailer-make/references/briefs.md +273 -0
  324. package/dist/skills/opengame-trailer-make/references/core.md +129 -0
  325. package/dist/skills/opengame-trailer-make/references/craft.md +299 -0
  326. package/dist/skills/opengame-trailer-make/references/edge-cases.md +27 -0
  327. package/dist/skills/opengame-trailer-make/references/filmable.md +244 -0
  328. package/dist/skills/opengame-trailer-make/references/finishing.md +126 -0
  329. package/dist/skills/opengame-trailer-make/references/gates.md +184 -0
  330. package/dist/skills/opengame-trailer-make/references/measure.md +282 -0
  331. package/dist/skills/opengame-trailer-make/references/music.md +148 -0
  332. package/dist/skills/opengame-trailer-make/references/og-clash-record.md +133 -0
  333. package/dist/skills/opengame-trailer-make/references/ops.md +154 -0
  334. package/dist/skills/opengame-trailer-make/references/owner-eye.md +214 -0
  335. package/dist/skills/opengame-trailer-make/references/review.md +141 -0
  336. package/dist/skills/opengame-trailer-make/references/title.md +92 -0
  337. package/dist/skills/opengame-trailer-plan/CHANGELOG.md +5 -0
  338. package/dist/skills/opengame-trailer-plan/SKILL.md +176 -0
  339. package/dist/skills/opengame-trailer-plan/references/archetypes.md +113 -0
  340. package/dist/skills/opengame-trailer-plan/references/briefs.md +273 -0
  341. package/dist/skills/opengame-trailer-plan/references/core.md +129 -0
  342. package/dist/skills/opengame-trailer-plan/references/craft.md +299 -0
  343. package/dist/skills/opengame-trailer-plan/references/edge-cases.md +27 -0
  344. package/dist/skills/opengame-trailer-plan/references/filmable.md +244 -0
  345. package/dist/skills/opengame-trailer-plan/references/finishing.md +126 -0
  346. package/dist/skills/opengame-trailer-plan/references/gates.md +184 -0
  347. package/dist/skills/opengame-trailer-plan/references/measure.md +282 -0
  348. package/dist/skills/opengame-trailer-plan/references/music.md +148 -0
  349. package/dist/skills/opengame-trailer-plan/references/og-clash-record.md +133 -0
  350. package/dist/skills/opengame-trailer-plan/references/ops.md +154 -0
  351. package/dist/skills/opengame-trailer-plan/references/owner-eye.md +214 -0
  352. package/dist/skills/opengame-trailer-plan/references/reference-set.md +92 -0
  353. package/dist/skills/opengame-trailer-plan/references/review.md +141 -0
  354. package/dist/skills/opengame-trailer-plan/references/title.md +92 -0
  355. package/dist/skills/opengame-trailer-review-and-improve/CHANGELOG.md +5 -0
  356. package/dist/skills/opengame-trailer-review-and-improve/SKILL.md +145 -0
  357. package/dist/skills/opengame-trailer-review-and-improve/references/archetypes.md +113 -0
  358. package/dist/skills/opengame-trailer-review-and-improve/references/briefs.md +273 -0
  359. package/dist/skills/opengame-trailer-review-and-improve/references/core.md +129 -0
  360. package/dist/skills/opengame-trailer-review-and-improve/references/craft.md +299 -0
  361. package/dist/skills/opengame-trailer-review-and-improve/references/edge-cases.md +27 -0
  362. package/dist/skills/opengame-trailer-review-and-improve/references/filmable.md +244 -0
  363. package/dist/skills/opengame-trailer-review-and-improve/references/finishing.md +126 -0
  364. package/dist/skills/opengame-trailer-review-and-improve/references/gates.md +184 -0
  365. package/dist/skills/opengame-trailer-review-and-improve/references/measure.md +282 -0
  366. package/dist/skills/opengame-trailer-review-and-improve/references/music.md +148 -0
  367. package/dist/skills/opengame-trailer-review-and-improve/references/og-clash-record.md +133 -0
  368. package/dist/skills/opengame-trailer-review-and-improve/references/ops.md +154 -0
  369. package/dist/skills/opengame-trailer-review-and-improve/references/owner-eye.md +214 -0
  370. package/dist/skills/opengame-trailer-review-and-improve/references/review.md +141 -0
  371. package/dist/skills/opengame-trailer-review-and-improve/references/title.md +92 -0
  372. package/dist/skills/opengame-verification/CHANGELOG.md +11 -0
  373. package/dist/skills/opengame-verification/SKILL.md +113 -48
  374. package/dist/skills/opengame-weapons/CHANGELOG.md +11 -0
  375. package/dist/skills/opengame-weapons/SKILL.md +129 -55
  376. package/dist/skills/opengame-weapons/references/handling-numbers.md +42 -0
  377. package/dist/skills/opengame-weapons/references/reloads-and-hands.md +96 -0
  378. package/dist/skills/opengame-weapons/references/sights-and-scopes.md +98 -0
  379. package/dist/skills/opengame-weapons/references/threejs.md +71 -0
  380. package/dist/skills/opengame-world-physics/CHANGELOG.md +9 -0
  381. package/dist/skills/opengame-world-physics/SKILL.md +55 -24
  382. package/dist/skills/opengame-world-physics/references/measured-failures.md +28 -1
  383. package/package.json +1 -1
@@ -1,17 +1,18 @@
1
1
  ---
2
2
  name: opengame-scene-audit
3
- description: Audit a 3D browser game's geometry with a script. It finds floating and buried props, solids inside each other, coplanar faces that z-fight, solids with no collider or a collider that does not fit, cameras inside solids and duplicate actors, runs a walk bot up every staircase without jumping, and proves each check on a planted defect first. Use when the person says things float, z-fighting, I can walk through things, the screen goes black, stairs are broken, or before calling a level finished.
3
+ description: Audit a 3D browser game's geometry with a script, and its flicker on film. Finds props floating off what is drawn, buried props, overlapping solids, faces tied on the shipped vertex grid, missing colliders and invisible walls, cameras inside solids and duplicate actors, walks every staircase, and proves each check on a planted defect. Use when the person says things float, z-fighting, flicker, invisible walls, I walk through things, the screen goes black, or before calling a level finished.
4
4
  metadata:
5
- version: "1.0.0"
5
+ version: "1.1.1"
6
6
  ---
7
7
 
8
8
  # Scene audit
9
9
 
10
10
  A scene that looks right in a still can be full of geometry that is wrong: a crate
11
11
  hovering a hand's width above the floor, two wall panels in one plane flickering as the
12
- camera moves, a fence nobody can collide with. These are answerable from the scene's own
13
- geometry, headless, in seconds. [helpers/scene-audit.js](helpers/scene-audit.js) does it;
14
- copy it into the game.
12
+ camera moves, a fence nobody can collide with, a wall of collision with nothing drawn on
13
+ it. Most of these are answerable from the scene's own geometry, headless, in seconds.
14
+ [helpers/scene-audit.js](helpers/scene-audit.js) does it; copy it into the game.
15
+ Flicker is the exception: it lives in motion, and only a film on a stepped clock judges it.
15
16
 
16
17
  Rules carry five tags; `opengame-quality-bar` explains them and the game codes.
17
18
 
@@ -32,41 +33,49 @@ console.log(formatReport(report))
32
33
  Mark meshes through `userData`: `collider: true` for collision geometry,
33
34
  `nocollide: 'foliage'` for drawn things a body may pass, `hangs: 'lamp on a chain'` for
34
35
  things held up by design, `group: 'truck'` for parts of one object that touch on
35
- purpose, `decal: true` for layered decals. In Node, build the same `{ parts, colliders,
36
- routes }` shape from the level's own layout data; the file imports nothing.
36
+ purpose, `decal: true` for layered decals, and `gridStep` for the vertex grid a part is
37
+ shipped on when the format quantises positions. A collider the player can see the reason
38
+ for (a fence line, a cliff edge) carries `userData.nodraw` with that reason. In Node,
39
+ build the same `{ parts, colliders, routes }` shape from the level's own layout data; the
40
+ file imports nothing.
37
41
 
38
42
  `report.ok` is true when the applicable checks caught their planted defects, examined
39
43
  the scene and found no defects. For a level with no stairs or ramps, pass
40
44
  `{ notApplicable: { stairs: "This level has no stairs or ramps" } }`. List a reason for
41
- each omitted check. An empty check without a reason remains a failure. Findings name the part, the world position and why.
45
+ each omitted check. An empty check without a reason remains a failure. Findings name the
46
+ part, the world position and why.
42
47
 
43
48
  The adapter reads each visible mesh as one world-space box plus its triangles. It skips
44
49
  skinned meshes (characters are judged in `opengame-characters`), and reads an
45
50
  `InstancedMesh` as one box around all its instances, so expand instanced props that
46
- matter into one part per instance before auditing them.
51
+ matter into one part per instance before auditing them. A mesh hidden in the scene graph
52
+ but marked `collider` is read as a collider nothing draws, and a `Box3` collider may carry a
53
+ `nodraw` property. Boxes are a first pass: a whole-map merged mesh or a terrain mesh read
54
+ as one box hides every collider under its top, so split those into chunks (or leave
55
+ terrain to `groundY`), and run the engine-side sweeps in the rules below for the rest.
47
56
 
48
57
  ## Rules
49
58
 
50
59
  ### Every check proves itself first
51
- - **Invariant:** No check reports on the real scene until it has found a known defect planted in it, and an applicable check that examined nothing is a failure.
52
- - **Technique:** Before measuring, plant a floating crate, a buried prop, two interpenetrating crates, two coplanar panels and a collider-less wall at an open site chosen from the real scene, and a staircase with one riser too tall. Report how many things each check examined.
53
- - **Reference configuration:** DK's first coplanar audit clipped triangles with inverted winding and measured 0 m² on every prop, including one already known to have 0.4 m². AW plants a defect for each of its eight checks into every map under test, and its plants have found two bugs in the checks themselves.
60
+ - **Invariant:** No check reports on the real scene until it has found a known defect planted in it, an applicable check that examined nothing is a failure, and a check never measures with the same inputs the fix it judges used.
61
+ - **Technique:** Before measuring, plant a floating crate, a buried prop, two interpenetrating crates, two coplanar panels, a collider-less wall and an undrawn collider at an open site chosen from the real scene, and a staircase with one riser too tall. Report how many things each check examined. When a check reaches zero by gaining filters or exemptions, plant a defect of each filtered kind and show it is still flagged before believing the zero.
62
+ - **Reference configuration:** DK's first coplanar audit clipped triangles with inverted winding and measured 0 m² on every prop, including one already known to have 0.4 m². AW plants a defect for each of its eight checks into every map under test, and its plants have found two bugs in the checks themselves. OS's integrity audit reached 0/0/0 by adding filters, and its lead refused it until every planted hole was flagged; its plant-grounding check read the same invisible card corners the grounding pass had moved and printed "0 still floating" over about 3,600 floating plants.
54
63
  - **Applies when:** Every audit, every run.
55
64
  - **Verify:** `formatReport` prints `plant caught` and a non-zero examined count for every check.
56
65
 
57
66
  ### No camera inside a solid
58
- - **Invariant:** No camera (gameplay, cinematic, menu or capture) has its near plane inside geometry, and no framed shot is mostly blocked by near cover.
59
- - **Technique:** Before using a camera position, test a sphere the size of the near plane against the colliders and cast from the subject to the camera; pull the camera in, or reject the position. Aim framed shots from the subject's live joints, so a change of scale moves the camera with it. Reject shots where near cover fills a large share of the frame. In a debug build, log every frame whose camera is inside a collider. In three.js run the test against the physics world (Rapier's shape-intersection queries) or `Box3.containsPoint` on collider boxes, and raycast from the subject with `Raycaster.far` set to the camera distance.
60
- - **Reference configuration:** OC's game-over screen rendered a black 3D layer from r57 to r66, about 7 hours, because its camera was 0.3 m inside a stone ledge: black at 66.33 m, the full scene at 66.22 m. A light at infinity was blamed first. OC's victory camera ended inside rubble, then inside the boss, and a change to the boss's scale broke every framed shot. OC rejects a shot with more than 25% near cover.
61
- - **Applies when:** Every 3D game with scripted, menu, capture or follow cameras.
67
+ - **Invariant:** No camera (gameplay, cinematic, spawn, menu or capture) has its near plane inside geometry, and no framed shot is mostly blocked by near cover.
68
+ - **Technique:** Before using a camera position, test a sphere the size of the near plane against the colliders and cast from the subject to the camera; pull the camera in, or reject the position. Aim framed shots from the subject's live joints, so a change of scale moves the camera with it. Reject shots where near cover fills a large share of the frame, and run the same test on every capture camera and every spawn's first view before anyone judges them. In a debug build, log every frame whose camera is inside a collider. In three.js run the test against the physics world (Rapier's shape-intersection queries) or `Box3.containsPoint` on collider boxes, and raycast from the subject with `Raycaster.far` set to the camera distance.
69
+ - **Reference configuration:** OC's game-over screen rendered a black 3D layer from r57 to r66, about 7 hours, because its camera was 0.3 m inside a stone ledge: black at 66.33 m, the full scene at 66.22 m. OC's victory camera ended inside rubble, then inside the boss. OC rejects a shot with more than 25% near cover. OS fails a capture camera or spawn view with more than 25% of the frame within 6 m, written after judges found five of ten first-person spawn views facing a boulder, a wall or grass; 13 of one map's first 39 staged cameras sat in walls, roofs or on cliffs.
70
+ - **Applies when:** Every 3D game with scripted, menu, capture, spawn or follow cameras.
62
71
  - **Verify:** Sample every authored camera and every ending camera at each boss scale and arena variant: the audit reports zero cameras inside solids, and the captures contain no black frame with the HUD still drawn.
63
72
 
64
- ### Nothing floats
65
- - **Invariant:** Every part is held up by the ground through some chain of contact, unless it hangs by design and says so.
66
- - **Technique:** Seed the supported set from parts resting on the ground or a published floor, then spread support through contact until nothing changes. Two parts touching each other in mid-air do not hold each other up.
67
- - **Reference configuration:** AW: a base more than 0.12 m (a hand's width) above its support floats; parts within 0.08 m touch. Ten AW boulders hung 0.13 m over a cliff path for nine rounds because each rock's base touched its own cap.
68
- - **Applies when:** Any 3D scene with props and structures.
69
- - **Verify:** The float check reports zero, and a planted crate above the floor is reported.
73
+ ### Nothing floats, measured on what is drawn
74
+ - **Invariant:** Every part's visible base is held up by the visible surface through some chain of contact, whatever placed it (authored, generated, at load or at runtime), unless it hangs by design and keeps hanging.
75
+ - **Technique:** Seed the supported set from parts resting on the ground or a published floor, then spread support through contact until nothing changes; two parts touching in mid-air do not hold each other up. Seat from drawn geometry: for an alpha card, the lowest opaque texel of each level of detail, never the card's corners. Cast centre and footprint rays against the terrain and the top level of detail; hide an instance over a ledge, otherwise tilt it a little and sink its low edge. Audit with a different measure from the one the placer used, against drawn triangles and excluding the object's own mesh. Keep the `hangs` exemption through every grounding pass. A prop that touches can still look afloat without contact shading, so check contact occlusion reaches it, alpha-tested materials included.
76
+ - **Reference configuration:** AW: a base more than 0.12 m (a hand's width) above its support floats; parts within 0.08 m touch; ten AW boulders hung 0.13 m over a cliff path for nine rounds because each rock's base touched its own cap. OS: "we cant have foliage/grass things floating on any fucking map! wtf si this bs?" (owner). Cards carried invisible skirts of 0.2 to 1.07 m below the blades; measured on the drawn base, floating plants went from 3,059 to 75 to 0 on 16 of 17 maps. Seating used 5 rays, a lean of at most 20 degrees and a 5 cm sink: "Losing a tuft is better than one floating." Runtime barriers floated 8 m up on roofs, and one grounding pass dragged a hanging plant "across a window". Ambient occlusion with a 1.1 m reach "left props floating" until 2.4 m, and alpha-tested materials had none at all.
77
+ - **Applies when:** Any 3D scene with props, procedural dressing, terrain edited after dressing, or anything placed at load or runtime.
78
+ - **Verify:** The float check reports zero, a planted floater on each placement path is flagged, and standing-eye frames agree with it (OS took 24 a map).
70
79
 
71
80
  ### Nothing is sunk
72
81
  - **Invariant:** A prop stands on the floor, not in it, while foundations and footings may go as deep as they need.
@@ -82,33 +91,40 @@ matter into one part per instance before auditing them.
82
91
  - **Applies when:** Any scene with placed solids.
83
92
  - **Verify:** The interpenetration check reports zero.
84
93
 
85
- ### No two faces in one plane
86
- - **Invariant:** No two visible opaque faces lie in the same plane facing the same way and overlapping, so nothing flickers as the camera moves.
87
- - **Technique:** Bin faces by normal and plane distance, clip candidate pairs against each other in their shared plane, and sum the overlap. Repair the geometry (cut, inset, overrun one member a few millimetres into the other) before reaching for depth bias; use polygon offset only for a real layered surface such as a decal.
88
- - **Reference configuration:** AW and DK: faces within 2 mm of one plane with more than 0.02 m² of overlap. DK's triangle audit found 187.7 m² of fighting surface, 150 m² of it from every crate drawing its rails twice. AW holds wall decals 4 to 90 mm off the wall.
89
- - **Applies when:** Every scene with opaque geometry, distant scenery included: a face that flickers on the skyline flickers on screen.
90
- - **Verify:** The coplanar check reports zero area. Then pan slowly at a grazing angle past the busiest joins.
94
+ ### No two faces within the shipped grid of one plane
95
+ - **Invariant:** No two visible faces facing the same way lie within two steps of the vertex grid they ship on (or a fixed tolerance, whichever is larger) and overlap, measured on the positions drawn after cooking and every load-time pass, and no zero-thickness double-sided sheet ships.
96
+ - **Technique:** Measure what the renderer draws: learn the format's position encoding, decode the cooked file, and flag same-facing faces within two grid steps of one plane, inside models and across them. Fix in this order: delete the hidden or back-to-back face first, then lift what must stay well clear of the tolerance (never less than the reference lift below, and at least two or three grid steps), and keep polygon offset for a dedicated overlay such as a decal. Make the fix the last step of every exporter so a re-export cannot bring a tie back. Prefer reversed floating-point depth where the renderer supports it, and recheck draw order after switching. The helper compares parts with each other: set `gridStep` per part (or for the scene), and scan inside each model in the exporter.
97
+ - **Reference configuration:** AW and DK work on float positions: faces within 2 mm of one plane with more than 0.02 m² of overlap; DK found 187.7 m² of fighting surface, 150 m² of it from every crate drawing its rails twice; AW holds wall decals 4 to 90 mm off the wall. OS stored positions at 16 bits per axis over each part's box, so grids ran from about 1.2 to 20 mm: the owner's stripe was faces 1.5 mm apart on a 1.22 mm grid, which an exact-tie check called safe, and a fixed 2 mm lift "rounded back into exact ties". That is why the rule counts grid steps. OS lifts at least 1 cm, two to three grid steps, and the owner pasted the rule twice: "never two visible surfaces in the same plane, lift decals ~1 cm along the normal or draw them with polygon offset (factor -1, units -4)". Lifting before deleting turned 8 spike pixels into 28,089; ties "re-grew" after re-exports until the fix ran last; across 1,192 models ties went from 98,914 to 721. LC: reversed depth made a 1 cm gap at 100 m draw 0 wrong pixels where the old buffer's steps were 24 mm there, but it also reversed draw order and the sky drew over everything; a z-fight mend that put jambs every quarter metre of a doorway made a slat wall bodies walked through, on main for 8 hours.
98
+ - **Applies when:** Every scene with opaque geometry, distant scenery included, and above all formats that quantise positions and kit-built, generated or merged maps.
99
+ - **Verify:** The decoded scan reads zero on the file that landed, the coplanar check reports zero area, and the motion path in the next rule shows the band gone.
100
+
101
+ ### Flicker is judged in motion, on a repeatable path, from every camera
102
+ - **Invariant:** No surface flickers, crawls or swaps while the camera moves, from any camera the game uses (play, aiming and zoom, spawn cinematics, menus, map edges, places a player cannot reach), and each reported flicker's cause is named before it is mended.
103
+ - **Technique:** Script a fixed sequence (still, turn, strafe, walk, and a zoomed pan) on the game's clock with a fixed step, so before and after film identical frames. Count A-B-A reversals after compensating motion with optical flow, mask the reticle and HUD, and score spike pixels per frame per spot. Then name each hotspot's cause with toggles in one session: stepping the near plane re-rolls only depth ties, turning the sun off removes shadow acne, turning temporal anti-aliasing off removes aliasing, and hiding one object at a time finds its owner. Prove the counter on a still frame first. Aliasing counts as flicker too; mend it with `opengame-look`'s thin-detail rule.
104
+ - **Reference configuration:** OS: "so much z fighting / flickering on so many maps still ... that needs to be 0 across all maps every inch..." and "u need to catch them all across every map even in areas u cant see while playing btu spawn in cinematics or around map" (owner). The owner's one word covered at least six causes: coplanar ties, back-face-lit sheets, sub-pixel trim, far-plane clipping, chain-link moiré and shadow stipple. Free-running captures varied 10 to 30%, the stepped path about 5%; the reticle mask removed 75 to 91% of false scoped spikes. The team's bar was 300 spike pixels per frame (0.015% of 1080p) and 13 of 17 maps passed it at the end; the owner never approved that bar, and his own was zero. LC: twenty world leads found 373 coplanar places while the flicker the owner saw was snow-edge noise, normal relief under a lamp at the lens, the lamp's shadow at contact range and ground relief ("nine guesses before that were wrong"), mended by fading sub-pixel relief and keeping normals from facing away from the viewer; with the camera pinned, the clock stopped and the lens moved a quarter pixel, flips fell from 1.64 to 0.00 per 1000 pixels walking. A recorder's grain counted as 209 flips per 1000 pixels and a 2 mm camera drift as flicker.
105
+ - **Applies when:** Any 3D game with temporal anti-aliasing, cascaded shadows, thin geometry, fine relief or zoom.
106
+ - **Verify:** A planted z-fight is flagged on the path, and every spot is under the bar or signed off with three consecutive 1:1 frames.
107
+
108
+ ### Stills catch joins, never motion
109
+ - **Invariant:** The places a person would inspect (contact points, joins, roofs, terrain edges, the skyline, and the view from every camera the game uses) have been inspected on fixed stills, and no still is offered as proof that nothing flickers.
110
+ - **Technique:** Place fixed cameras once per level (two at grazing angles along major walls, one looking up at a ceiling join, one along a terrain edge, one across the busiest floor at prop height, one at the skyline), plus each spawn view, cinematic and menu camera, captured every round so the same views compare before and after. Judge flicker, shimmer and popping only on the motion path of the rule above.
111
+ - **Reference configuration:** DK's report of a cabinet whose side fought its skin came from a player's photograph at exactly such a join. OS's still sweeps, with temporal anti-aliasing and the sun off, called maps "clean" or showed "faint specks" for eight days while the owner saw "a lot, IN MOTION"; anti-aliasing on raised the count 7.5 times. This rule was "Freeze the frame and look closely" and was offered as a flicker check; it no longer is.
112
+ - **Applies when:** Every 3D level.
113
+ - **Verify:** The same stills each round with the same camera transforms, reviewed by somebody who did not build the level, beside the motion path's numbers.
91
114
 
92
- ### Every visible solid blocks the body
93
- - **Invariant:** Anything drawn solid has a collider or a stated reason it does not.
94
- - **Technique:** Compare visible solids with the collision layer; give each uncovered one a collider or a `nocollide` reason. Check fit as well as presence: report any collider whose box covers clearly less than its mesh, and any walkable or blocking prop (railing, low wall, pier, roof, fence) with none.
95
- - **Reference configuration:** AW's body-physics gate found bodies reaching positions inside drawn opaque volume with no collider on every map. OC's palisade, fences, railings and roofs had no collider, and its building boxes covered 84% of the footprint (`opengame-world-physics` has the rest).
96
- - **Applies when:** Every game with a walking body.
97
- - **Verify:** The colliders check reports zero; the walk bot reports no walk-throughs. The walk bot only sees the routes you give it, so the colliders check is the one that covers the whole level.
115
+ ### Collision is audited against the picture in both directions
116
+ - **Invariant:** Every drawn solid blocks a body or says why it does not, and no collider blocks where nothing is drawn unless the player can see why they are stopped.
117
+ - **Technique:** Compare the visible solids with the collision layer both ways. Drawn side: give each uncovered solid a collider or a `nocollide` reason, and report colliders that cover clearly less than their mesh. Undrawn side: report any collider with nothing drawn in it, or with only walk-through things (foliage, decals) drawn in it, unless it carries a `nodraw` reason the player can see. The `colliders` and `invisible` checks do both at box level. In the engine, sweep rays from every reachable cell comparing the first drawn face with the first solid, walk a probe body at every placed thing from four sides, report by category (invisible wall, invisible bullet stop, walk-through, low ceiling, open edge, a lid over a reachable roof), test size rules in each collider's own frame rather than its world box, and let each count only go down.
118
+ - **Reference configuration:** OS's most repeated map defect was the undrawn side: "theres random invisible like walls that u cant walk through on map btw?" and "still has a ton of invisible walls u cant walk or run or shoot through" (owner), about 40 collision notes in five days, from colliders of removed gates, clipped bushes and a substring match ("'pine' inside 'alpine' and 'tree' inside 'street'"); on one map player walls went from 1,195 to 2 and bullet-stopping cells from 526 to 38, each kept with a reason, yet at the end another map still had 178 shot-through cells, and a rotated railing had been read as a roof lid because a size rule used its world box. LC's ray grid, 271,936 rays from 4,249 standpoints, found 1,569 solids with nothing drawn on 30 colliders, then 0. AW's body-physics gate found bodies inside drawn opaque volume with no collider on every map; OC's palisade, fences, railings and roofs had none, and its building boxes covered 84% of the footprint. The walk bot only sees the routes you give it, so these checks are the ones that cover the whole level.
119
+ - **Applies when:** Every game with a walking body or projectiles.
120
+ - **Verify:** The colliders and invisible checks report zero with their plants caught, the walk bot reports no walk-throughs, and the engine's sweep counts are at or below the last good build.
98
121
 
99
122
  ### Every staircase climbed forward-only
100
- - **Invariant:** The walk bot reaches the top of every flight holding forward, with no jump.
101
- - **Technique:** Add a route for every staircase, ramp and ladder-free climb in the level. The bot is a capsule that steps up at most one step height and slides along whatever blocks it.
102
- - **Reference configuration:** AW's body radius 0.35 m, height 1.8 m and step 0.42 m are the bot's defaults; pass the game's own numbers as `tolerances`. OC's owner raised stairs that needed a jump 3 times; OC settled on a 0.4 m step for the player and the zombies alike. Run the routes a second time with the AI body's numbers when they differ from the player's (`opengame-world-physics`).
103
- - **Applies when:** Any game with stairs or ramps.
104
- - **Verify:** The stairs check examined as many routes as the level has flights and reports zero.
105
-
106
- ### Freeze the frame and look closely
107
- - **Invariant:** The places a person would inspect have been inspected: contact points, joins, roofs, terrain edges, the skyline.
108
- - **Technique:** Six fixed cameras placed once per level (two at grazing angles along major walls, one looking up at a ceiling join, one along a terrain edge, one across the busiest floor at prop height, one at the skyline) captured every round, so the same views can be compared before and after.
109
- - **Reference configuration:** DK's report of a cabinet whose side fought its skin came from a player's photograph at exactly such a join.
110
- - **Applies when:** Every 3D level.
111
- - **Verify:** Six captures per round, with the same camera transforms, reviewed by somebody who did not build the level.
123
+ - **Invariant:** The walk bot reaches past the top of every flight, ramp and ladder holding forward, with no jump, and a route passes only when the body ends beyond the obstacle.
124
+ - **Technique:** Add a route for every staircase, ramp and narrow opening in the level, and one from each ladder's top onto the floor past it, with every goal beyond the landing, not on it. The bot is a capsule that steps up at most one step height and slides along whatever blocks it.
125
+ - **Reference configuration:** AW's body radius 0.35 m, height 1.8 m and step 0.42 m are the bot's defaults; pass the game's own numbers as `tolerances`. OC's owner raised stairs that needed a jump 3 times; OC settled on a 0.4 m step for the player and the zombies alike. OS's old walk passed a railing bug by stopping 0.42 m short, and a ladder with less than 1.2 m clear past its top could be climbed and not left. Run the routes again with the AI body's numbers when they differ from the player's (`opengame-world-physics`).
126
+ - **Applies when:** Any game with stairs, ramps, ladders or narrow openings.
127
+ - **Verify:** The stairs check examined as many routes as the level has flights and climbs, and reports zero.
112
128
 
113
129
  ### Each actor is drawn once
114
130
  - **Invariant:** Each screen shows the expected number of each actor: one boss, one player character, no frozen leftover copy.
@@ -120,4 +136,5 @@ matter into one part per instance before auditing them.
120
136
  ## Tuning
121
137
 
122
138
  Every tolerance is in `TOLERANCES` and can be overridden per run. Change them for a
123
- different scale (a miniature world, a giant), never to make a finding go away.
139
+ different scale (a miniature world, a giant), or set `gridStep` to the grid the game
140
+ ships on, never to make a finding go away.
@@ -1,7 +1,8 @@
1
1
  /**
2
2
  * A geometry audit for a 3D game scene: floating props, buried props, solids driven
3
- * through each other, coplanar faces that z-fight, visible solids with no collider, and
4
- * a walk bot that climbs every staircase holding forward only. No GPU, no browser.
3
+ * through each other, coplanar faces that z-fight, visible solids with no collider,
4
+ * colliders with nothing drawn (invisible walls), and a walk bot that climbs every
5
+ * staircase holding forward only. No GPU, no browser.
5
6
  *
6
7
  * Copy this file into the game and feed it the scene the game actually builds:
7
8
  *
@@ -21,9 +22,12 @@
21
22
  * group parts emitted together as one object; they may touch and overlap
22
23
  * triangles optional [[ax,ay,az, bx,by,bz, cx,cy,cz], ...] for the coplanar check;
23
24
  * boxes without triangles contribute their six faces
24
- * plus `colliders` (boxes the controller collides with), `ramps` (invisible stair
25
- * ramps), `groundY` (a number or a function of x and z), `floors` (walkable heights)
26
- * and `routes` for the walk bot.
25
+ * gridStep the step of the vertex grid this part is shipped on, in metres, when the
26
+ * format quantises positions; faces within two steps of one plane tie
27
+ * plus `colliders` (boxes the controller collides with, each optionally carrying
28
+ * `nodraw`: a reason the player can see why it stops them, such as "fence line"),
29
+ * `ramps` (invisible stair ramps), `groundY` (a number or a function of x and z),
30
+ * `floors` (walkable heights) and `routes` for the walk bot.
27
31
  *
28
32
  * EVERY CHECK PLANTS A DEFECT FIRST. Before measuring the real scene, each check runs on
29
33
  * a copy with a known defect placed at a site it chooses from the real scene, and the
@@ -45,7 +49,9 @@ export const TOLERANCES = Object.freeze({
45
49
  penFraction: 0.2, // a fifth of the smaller part inside the other
46
50
  penSlack: 0.05, // slack on "deeper than the thinner part"
47
51
  zEps: 0.002, // faces closer than this to one plane have no depth winner
52
+ gridStep: 0, // shipped vertex grid for every part; two steps widen zEps
48
53
  zArea: 0.02, // overlap smaller than this many square metres is not visible
54
+ invisibleShare: 0.25, // a quarter of a collider with nothing drawn in it is a wall
49
55
  bodyRadius: 0.35, bodyHeight: 1.8, stepHeight: 0.42, walkSpeed: 4.9,
50
56
  stuckSeconds: 1.0, routeSeconds: 30,
51
57
  });
@@ -261,20 +267,27 @@ export function overlapArea(t1, t2, n) {
261
267
  */
262
268
  export function checkCoplanar(scene, tol = TOLERANCES) {
263
269
  const faces = [];
270
+ // A format that stores positions on a grid rounds faces closer than a step or two
271
+ // into one plane, so "within 2 mm" passes real ties on a coarse grid. The pair's
272
+ // tolerance is two steps of the coarser of its two grids, or zEps if that is larger.
273
+ const stepOf = (p) => Math.max(tol.gridStep ?? 0, p.gridStep ?? 0);
274
+ let eps = tol.zEps;
275
+ for (const p of scene.parts) eps = Math.max(eps, 2 * stepOf(p));
276
+ const pairEps = (f, g) => Math.max(tol.zEps, 2 * Math.max(f.step, g.step));
264
277
  for (const p of scene.parts) {
265
278
  if (p.visible === false || !isSolid(p) || p.decal) continue;
266
279
  for (const t of p.triangles ?? boxTriangles(p)) {
267
280
  const n = triNormal(t);
268
281
  if (!n) continue;
269
282
  const d = n[0] * t[0] + n[1] * t[1] + n[2] * t[2];
270
- if (n[1] < -0.999 && (scene.floors ?? [groundAt(scene, t[0], t[2])]).some((f) => f !== null && Math.abs(-d - f) < tol.zEps)) continue;
271
- faces.push({ part: p.id, group: p.group, t, n, d, min: [0, 1, 2].map((a) => Math.min(t[a], t[3 + a], t[6 + a])), max: [0, 1, 2].map((a) => Math.max(t[a], t[3 + a], t[6 + a])) });
283
+ if (n[1] < -0.999 && (scene.floors ?? [groundAt(scene, t[0], t[2])]).some((f) => f !== null && Math.abs(-d - f) < Math.max(tol.zEps, 2 * stepOf(p)))) continue;
284
+ faces.push({ part: p.id, group: p.group, step: stepOf(p), t, n, d, min: [0, 1, 2].map((a) => Math.min(t[a], t[3 + a], t[6 + a])), max: [0, 1, 2].map((a) => Math.max(t[a], t[3 + a], t[6 + a])) });
272
285
  }
273
286
  }
274
287
  const bins = new Map();
275
288
  const keyOf = (f, slot) => `${Math.round(f.n[0] * 1000)},${Math.round(f.n[1] * 1000)},${Math.round(f.n[2] * 1000)},${slot}`;
276
289
  for (const f of faces) {
277
- const slot = Math.floor(f.d / tol.zEps);
290
+ const slot = Math.floor(f.d / eps);
278
291
  const key = keyOf(f, slot);
279
292
  if (!bins.has(key)) bins.set(key, []);
280
293
  bins.get(key).push(f);
@@ -282,14 +295,15 @@ export function checkCoplanar(scene, tol = TOLERANCES) {
282
295
  const pairs = new Map();
283
296
  let examined = 0;
284
297
  for (const f of faces) {
285
- const slot = Math.floor(f.d / tol.zEps);
298
+ const slot = Math.floor(f.d / eps);
286
299
  for (const s of [slot, slot + 1]) {
287
300
  for (const g of bins.get(keyOf(f, s)) ?? []) {
288
301
  if (g === f || g.part === f.part || (f.group !== undefined && f.group === g.group)) continue;
289
302
  if (s === slot && g.part < f.part) continue; // count each cross-part pair once
290
- if (f.n[0] * g.n[0] + f.n[1] * g.n[1] + f.n[2] * g.n[2] < 0.9999 || Math.abs(f.d - g.d) > tol.zEps) continue;
303
+ const within = pairEps(f, g);
304
+ if (f.n[0] * g.n[0] + f.n[1] * g.n[1] + f.n[2] * g.n[2] < 0.9999 || Math.abs(f.d - g.d) > within) continue;
291
305
  let apart = false;
292
- for (let a = 0; a < 3; a++) if (f.min[a] > g.max[a] + tol.zEps || g.min[a] > f.max[a] + tol.zEps) { apart = true; break; }
306
+ for (let a = 0; a < 3; a++) if (f.min[a] > g.max[a] + within || g.min[a] > f.max[a] + within) { apart = true; break; }
293
307
  if (apart) continue;
294
308
  examined++;
295
309
  const area = overlapArea(f.t, g.t, f.n);
@@ -322,6 +336,49 @@ export function checkColliders(scene) {
322
336
  return { name: "colliders", examined, findings };
323
337
  }
324
338
 
339
+ /**
340
+ * invisible: the other direction. A collider with nothing drawn where it blocks is an
341
+ * invisible wall, and in our games it was the more repeated complaint of the two: one
342
+ * shooter's owner reported invisible walls in at least sixteen messages over ten days,
343
+ * one of them two hours after a removal was reported done. A collider counts as drawn where it
344
+ * lies inside a visible part that is neither walk-through (`nocollide`) nor a decal, so
345
+ * a collider over nothing but foliage is reported too. Collision under the ground is
346
+ * not judged: the share is of the part above ground, which is the part a body meets. A
347
+ * blocker the player can see the reason for (a fence line, a cliff edge) says so with
348
+ * `nodraw`. A flat collider (an invisible lid over a roof) is judged as if it had a thin
349
+ * thickness, so a sheet with no volume is still reported.
350
+ *
351
+ * Box level only: each part is its bounding box. An L-shaped mesh's box hides a collider
352
+ * in its empty corner, and a whole-map merged mesh or a terrain mesh read as one box
353
+ * hides every collider under its top, so split those into chunks (or leave terrain to
354
+ * `groundY`) before trusting a zero here. Run a ray sweep in the engine for the rest.
355
+ */
356
+ export function checkInvisible(scene, tol = TOLERANCES) {
357
+ const colliders = scene.colliders ?? scene.parts.filter((p) => p.collider);
358
+ const drawn = scene.parts.filter((p) => p.visible !== false && !p.nocollide && !p.decal);
359
+ const m = tol.contactTol, n = 4, thin = 0.05;
360
+ const inside = (p, x, y, z) => x >= p.min[0] - m && x <= p.max[0] + m && y >= p.min[1] - m && y <= p.max[1] + m && z >= p.min[2] - m && z <= p.max[2] + m;
361
+ const findings = [];
362
+ colliders.forEach((c, i) => {
363
+ if (typeof c.nodraw === "string" && c.nodraw.trim()) return;
364
+ let empty = 0, above = 0;
365
+ for (let ix = 0; ix < n; ix++) for (let iy = 0; iy < n; iy++) for (let iz = 0; iz < n; iz++) {
366
+ const x = c.min[0] + ((ix + 0.5) / n) * sizeOf(c, 0), y = c.min[1] + ((iy + 0.5) / n) * sizeOf(c, 1), z = c.min[2] + ((iz + 0.5) / n) * sizeOf(c, 2);
367
+ const ground = groundAt(scene, x, z);
368
+ if (ground !== null && y <= ground) continue;
369
+ above++;
370
+ if (!drawn.some((p) => inside(p, x, y, z))) empty++;
371
+ }
372
+ if (above === 0) return;
373
+ const share = empty / above;
374
+ const volume = [0, 1, 2].reduce((v, a) => v * Math.max(sizeOf(c, a), thin), 1) * (empty / n ** 3);
375
+ if (share > tol.invisibleShare && volume > tol.penVolume) {
376
+ findings.push({ id: c.id ?? `collider${i}`, at: site(c), why: `${Math.round(share * 100)}% of this collider has nothing drawn in it and no nodraw reason: an invisible wall` });
377
+ }
378
+ });
379
+ return { name: "invisible", examined: colliders.length, findings };
380
+ }
381
+
325
382
  /* the walk bot ---------------------------------------------------------------- */
326
383
 
327
384
  function rampHeight(ramp, x, z) {
@@ -501,7 +558,11 @@ const PLANTS = {
501
558
  coplanar(scene, tol) {
502
559
  const s = plantSite(scene, tol); if (!s) return null;
503
560
  const copy = clone(scene);
504
- copy.parts.push(box("planted-panel-a", s.x - 0.25, s.y, s.z, 1, 1, 0.2), box("planted-panel-b", s.x + 0.25, s.y + 0.3, s.z, 1, 1, 0.2));
561
+ // On a quantised grid the plant sits a step and a half apart, not exactly tied, so a
562
+ // grid tolerance that stopped widening the check would miss it.
563
+ let step = tol.gridStep ?? 0;
564
+ for (const p of scene.parts) step = Math.max(step, p.gridStep ?? 0);
565
+ copy.parts.push(box("planted-panel-a", s.x - 0.25, s.y, s.z, 1, 1, 0.2, { gridStep: step }), box("planted-panel-b", s.x + 0.25, s.y + 0.3, s.z + 1.5 * step, 1, 1, 0.2, { gridStep: step }));
505
566
  return { scene: copy, id: "planted-panel-a + planted-panel-b" };
506
567
  },
507
568
  colliders(scene, tol) {
@@ -510,12 +571,21 @@ const PLANTS = {
510
571
  copy.parts.push(box("planted-ghost-wall", s.x, s.y, s.z, 1.6, 2, 0.2, { collider: false }));
511
572
  return { scene: copy, id: "planted-ghost-wall" };
512
573
  },
574
+ invisible(scene, tol) {
575
+ const s = plantSite(scene, tol); if (!s) return null;
576
+ const copy = clone(scene);
577
+ const wall = box("planted-invisible-wall", s.x, s.y, s.z, 1.6, 2, 0.2);
578
+ // A scene with its own collision layer gets the wall there; a scene whose drawn
579
+ // parts are their own colliders gets an undrawn part that collides.
580
+ if (copy.colliders) copy.colliders.push(wall); else copy.parts.push({ ...wall, visible: false });
581
+ return { scene: copy, id: "planted-invisible-wall" };
582
+ },
513
583
  stairs(_scene, tol) {
514
584
  return { scene: stairScene(0.17, tol.stepHeight + 0.08), id: "planted stairs" };
515
585
  },
516
586
  };
517
587
 
518
- const CHECKS = { float: checkFloat, buried: checkBuried, interpenetration: checkInterpenetration, coplanar: checkCoplanar, colliders: checkColliders, stairs: checkStairs };
588
+ const CHECKS = { float: checkFloat, buried: checkBuried, interpenetration: checkInterpenetration, coplanar: checkCoplanar, colliders: checkColliders, invisible: checkInvisible, stairs: checkStairs };
519
589
 
520
590
  /**
521
591
  * Runs every check (or `only`), each after its plant. Returns
@@ -562,7 +632,9 @@ export function formatReport(report) {
562
632
  /**
563
633
  * Reads a three.js scene into the audit's shape. Pass the THREE namespace the game
564
634
  * already imports. Mesh flags come from `userData`: `collider`, `nocollide` (a reason),
565
- * `hangs` (a reason), `group`, `prop`, `decal`. Transparent and alpha-tested materials
635
+ * `hangs` (a reason), `group`, `prop`, `decal`, `gridStep`; a collider object may carry
636
+ * `userData.nodraw` (a reason the player can see why it stops them), and a Box3 a
637
+ * `nodraw` property. A hidden mesh marked `collider` is read as a collider nothing draws. Transparent and alpha-tested materials
566
638
  * are not opaque volume. `colliders` may be Box3s or meshes from the collision layer.
567
639
  */
568
640
  export function fromThreeScene(THREE, root, { colliders = [], groundY = null, floors, triangles = true } = {}) {
@@ -570,14 +642,20 @@ export function fromThreeScene(THREE, root, { colliders = [], groundY = null, fl
570
642
  const parts = [];
571
643
  const v = new THREE.Vector3();
572
644
  root.traverse((object) => {
573
- if (!object.isMesh || !object.visible || object.isSkinnedMesh) return;
645
+ if (!object.isMesh || object.isSkinnedMesh) return;
574
646
  const material = Array.isArray(object.material) ? object.material[0] : object.material;
647
+ const data = object.userData ?? {};
648
+ // A mesh is drawn only if it and every ancestor are visible and its material draws.
649
+ // A hidden mesh that collides is still read, as an undrawn collider, so a collision
650
+ // layer kept in the scene graph can be judged by the invisible check.
651
+ let shown = material?.visible !== false;
652
+ for (let o = object; o && shown; o = o.parent) if (!o.visible) shown = false;
653
+ if (!shown && data.collider !== true) return;
575
654
  const opaque = !material || (!material.transparent && (material.alphaTest ?? 0) === 0 && (material.opacity ?? 1) >= 1);
576
655
  const bounds = new THREE.Box3().setFromObject(object);
577
656
  if (bounds.isEmpty()) return;
578
- const data = object.userData ?? {};
579
- const part = { id: object.name || object.uuid, min: bounds.min.toArray(), max: bounds.max.toArray(), solid: opaque && !data.decal,
580
- collider: data.collider === true, nocollide: data.nocollide, hangs: data.hangs, group: data.group, prop: data.prop, decal: data.decal || material?.polygonOffset };
657
+ const part = { id: object.name || object.uuid, min: bounds.min.toArray(), max: bounds.max.toArray(), visible: shown ? undefined : false, solid: opaque && !data.decal,
658
+ collider: data.collider === true, nodraw: data.nodraw, nocollide: data.nocollide, hangs: data.hangs, group: data.group, prop: data.prop, decal: data.decal || material?.polygonOffset, gridStep: data.gridStep };
581
659
  if (triangles && object.geometry?.attributes?.position) {
582
660
  const position = object.geometry.attributes.position, index = object.geometry.index;
583
661
  const count = index ? index.count : position.count;
@@ -593,7 +671,7 @@ export function fromThreeScene(THREE, root, { colliders = [], groundY = null, fl
593
671
  });
594
672
  const boxes = colliders.map((c, i) => {
595
673
  const b = c.isBox3 ? c : new THREE.Box3().setFromObject(c);
596
- return { id: c.name || `collider${i}`, min: b.min.toArray(), max: b.max.toArray() };
674
+ return { id: c.name || `collider${i}`, min: b.min.toArray(), max: b.max.toArray(), nodraw: c.userData?.nodraw ?? c.nodraw };
597
675
  });
598
676
  return { parts, colliders: boxes.length ? boxes : undefined, groundY, floors };
599
677
  }
@@ -1,5 +1,17 @@
1
1
  # opengame-sdk changelog
2
2
 
3
+ ## 1.0.13
4
+
5
+ Invite links: `og.invite.link(code)` is the game's page on opengame.io with `?join=CODE`, and `og.invite.code` is the code a player arrived with, so a game's own lobby links open on OpenGame and drop the friend straight into the lobby.
6
+
7
+ ## 1.0.12
8
+
9
+ Profile sharing is no longer a setting: every signed-in player with a handle sends their handle, number and OG, and they are null for a guest, an account without a handle and a private preview. Any signed-in account can deploy, so only a CLI with no login hears that OpenGame is not open yet. The docs at docs.opengame.io are public, and the skill links them by address.
10
+
11
+ ## 1.0.11
12
+
13
+ Pause in a shared online match stops the player's own input and sound rather than the match, and points to `opengame-multiplayer` for how a host hands over.
14
+
3
15
  ## 1.0.10
4
16
 
5
17
  og.player.stats() reads the player's own entry on every board in one request, a career board's row for all runs included, so XP and levels can be read back into a game. Higher event and score budgets, up to 25 boards a game, and no need to credit OG Radio's music.
@@ -2,15 +2,15 @@
2
2
  name: opengame-sdk
3
3
  description: Integrate a browser game with OpenGame through @opengamehq/sdk, the injected global or a native engine bridge. Covers start-up, the player and their OG at load, names, leaderboards, achievements, events, pause, mute, fullscreen, keys inside the frame and threaded builds. Use when the person says integrate with OpenGame, add the SDK, show the player's name or OG, add a leaderboard or achievement, track events, fix fullscreen or keys in the game frame, or asks how a game talks to OpenGame.
4
4
  metadata:
5
- version: "1.0.10"
5
+ version: "1.0.13"
6
6
  ---
7
7
 
8
8
  # Integrate a game with OpenGame
9
9
 
10
10
  Inside an OpenGame page the SDK works as described here. Under `opengame dev` it runs a
11
- local stand-in that keeps scores and events in the browser. Until 18 November, the CLI
12
- that deploys the game prints "OpenGame opens for creators on 18 November." for anybody
13
- outside the OpenGame team; write the SDK calls now, and they are exercised on OpenGame once it opens.
11
+ local stand-in that keeps scores and events in the browser. Any signed-in account can deploy
12
+ now. Until 18 November, a CLI with no login hears
13
+ "OpenGame opens for creators on 18 November." Sign in with `opengame login` first.
14
14
 
15
15
  The SDK is what ends up inside the game. It talks only to the OpenGame page around
16
16
  the game and to `https://api.opengame.gg`.
@@ -37,7 +37,7 @@ read the copy the game will ship before writing a call:
37
37
  - `node_modules/@opengamehq/sdk/AGENTS.md`: the short rules and the error catalogue,
38
38
  generated from the SDK's own error table.
39
39
  - `node_modules/@opengamehq/sdk/dist/*.d.ts`: the exact signatures.
40
- - With no package to hand, the SDK reference (`/reference/sdk` in the private docs).
40
+ - With no package to hand, the SDK reference (`https://docs.opengame.io/reference/sdk`).
41
41
 
42
42
  Never guess a name. A call that is not in that README does not exist in that version.
43
43
  Where this skill and the installed README disagree, follow the README and tell the
@@ -126,7 +126,7 @@ Clash's scoreboard stuck open over the pause menu). Cancel the default of every
126
126
  turn, arrow, Space and Page key the game consumes, so the page around it does not
127
127
  scroll.
128
128
 
129
- **HIGH: pause and mute are honoured.** `og.onPause` stops simulation, timers and audio;
129
+ **HIGH: pause and mute are honoured.** `og.onPause` stops simulation, timers and audio (a game in a shared online match stops only its own input and sound, and `opengame-multiplayer` says how a host hands over);
130
130
  `og.audio.onHostMute` silences the game. The frame boots under a poster before the
131
131
  player presses Play, muted and paused from the first handshake, so keep loading through
132
132
  the pause. Start audio only from an `onHostMute(false)` that arrives after
@@ -136,8 +136,7 @@ the pause. Start audio only from an `onHostMute(false)` that arrives after
136
136
  player for or shows as theirs, such as a call sign, trainer name, player name, nickname,
137
137
  or their own HUD label or nameplate, is filled from `og.player.handle` inside
138
138
  `og.player.onChange`, so a signed-in player starts with the name they chose on OpenGame.
139
- `handle` is null for a guest, an account without a handle, a player not sharing their OG
140
- in games and every private preview; then keep the game's own default. Stop filling once
139
+ `handle` is null for a guest, an account without a handle and every private preview; then keep the game's own default. Stop filling once
141
140
  the player edits the field, and when the game restores a name the player saved, show
142
141
  that one instead. Allow 20 characters, `_` and `-` included, in
143
142
  the field's `maxlength`, in the game's own name check and wherever the name is drawn.
@@ -200,6 +199,24 @@ time are measured by the page; do not track them yourself.
200
199
  Focus, the poster, pause, mute, fullscreen, keys, scrolling and opening an outside link
201
200
  with `og.openLink`: [references/frame.md](references/frame.md).
202
201
 
202
+ ## Invite links for a game's own lobbies
203
+
204
+ OpenGame runs no rooms; a multiplayer game brings its own (`opengame-multiplayer`). The
205
+ SDK gives it the link to share and the code a friend arrives with:
206
+
207
+ ```js
208
+ await og.init()
209
+ if (og.invite.code) joinLobby(og.invite.code) // opened from an invite: skip the menu
210
+ else showInvite(og.invite.link(lobbyCode) ?? lobbyCode) // hosting: share this; the code when null
211
+ ```
212
+
213
+ **HIGH: share `og.invite.link(code)`, never the game's own address.** The link is the game's
214
+ page on opengame.io with `?join=CODE`: whoever opens it gets the game on OpenGame, as
215
+ themselves, and lands in the lobby. A link to `<label>.opengame.gg` opens a warning page instead of the
216
+ game. A code is 4 to 12 capitals and digits, or exactly 22 of `A-Z a-z 0-9 _ -`; `link`
217
+ returns null for anything else, rather than a link whose code the page would change.
218
+ Under `opengame dev` the link is the local page, so two tabs can try it.
219
+
203
220
  ## OG Radio
204
221
 
205
222
  Players can pick OG Radio stations and songs in the game's menu and listen while they
@@ -266,5 +283,5 @@ Run each check and say which ones you could not run; an unrun check is unverifie
266
283
  - Every board and achievement used in code is declared in `opengame.json`, and
267
284
  `opengame check . --json` passes.
268
285
  - On the published game, signed in as a confirmed member (the only accounts given a
269
- player during the private rollout) with sharing on, then with it off: the handle
286
+ player during the private rollout) with a handle, then as a guest: the handle
270
287
  shows only in the first case.
@@ -89,5 +89,5 @@ isolation headers. The game still has three things to do:
89
89
  All three must read `true`. `opengame dev . --contract` with the isolated contract
90
90
  serves the same headers locally, but only the preview is the real page and frame.
91
91
 
92
- Memory diagnostics, WebGPU and each engine's export settings are in the private docs
93
- under engines.
92
+ Memory diagnostics, WebGPU and each engine's export settings are in the docs at
93
+ `https://docs.opengame.io/engines/overview`.
@@ -2,9 +2,8 @@
2
2
 
3
3
  | Situation | `id` | `handle`, `ogNumber` | `avatar` | `signedIn` |
4
4
  | --- | --- | --- | --- | --- |
5
- | Signed in, sharing their OG in games (the default for new accounts), with a handle | Stable for this player in this game, on every device | Their public handle and number | Their head, and their outfit if they have one | `true` |
6
- | Signed in, sharing off (turned off, or an older account that never turned it on) | Stable as above | `null` | `null` | `true` |
7
- | Signed in, no handle claimed yet | Stable as above | `null` | As sharing allows | `true` |
5
+ | Signed in, with a handle | Stable for this player in this game, on every device | Their public handle and number | Their head, and their outfit if they have one | `true` |
6
+ | Signed in, no handle claimed yet | Stable as above | `null` | Their OG, if they have made one | `true` |
8
7
  | Guest | `null` while accounts are in private testing; otherwise stable in this browser for this game | `null` | `null` | `false` |
9
8
  | Private preview | `null`. Identity is not offered; scores stay separate from public ones | `null` | `null` | `false` |
10
9
  | Outside OpenGame, by default | `dev-guest` | `null` | `null` | `false` |
@@ -52,11 +51,11 @@ known, under the loading screen, fixed it.
52
51
 
53
52
  - The per-game `id` cannot be joined across games: the same person has a different id
54
53
  in every game. That is the point of it; do not try to work around it.
55
- - `handle` and `ogNumber` are public profile values, the same across games, and only
56
- for a player who shares them, which new accounts do by default. A game may show
57
- them, link them and recognise a returning handle; say so in the game's own copy if
58
- it matters to players. A player can turn sharing off at any time, so fall back to a
59
- guest name when they are `null`. They are never a storage key, because they can be
54
+ - `handle` and `ogNumber` are public profile values, the same across games, sent for
55
+ every signed-in player who has claimed a handle; there is no setting to withhold
56
+ them. A game may show them, link them and recognise a returning handle; say so in
57
+ the game's own copy if it matters to players. Fall back to a guest name when they
58
+ are `null`. They are never a storage key, because they can be
60
59
  null for a signed-in player and can change.
61
60
  - The SDK never gives the game an email, the account's real id, a friends list or a
62
61
  browser fingerprint, and a game should never ask for them.
@@ -96,7 +95,7 @@ save your score"). The game keeps running; `onChange` fires when they return sig
96
95
  ## The player's OG
97
96
 
98
97
  `og.player.avatar` is `{ seed, palette, look?, character? }`. `look` (the head) arrives
99
- only when the player is signed in, has turned on "Show my OG in games" and has made one;
98
+ only when the player is signed in and has made one;
100
99
  `character` (the body and outfit) arrives only beside a `look`. A guest, and every
101
100
  player in a private preview, gets null, and then `og.capabilities` has no `avatar`.
102
101
  With no `look`, draw the game's default.
@@ -108,5 +107,5 @@ const stop = watchAvatar(og, avatar => avatar ? useYourOg(avatar) : useDefaultCh
108
107
 
109
108
  `watchAvatar` calls at once and then only when the recipe changes, so a model is not
110
109
  rebuilt on every session refresh. `readAvatar` names the parts of one recipe. Do not
111
- store the recipe or send it anywhere; a player who turns sharing off expects their OG
112
- to leave the game. Building and showing it is in `opengame-characters`.
110
+ store the recipe or send it anywhere; a player who changes or deletes their OG expects
111
+ the game to follow. Building and showing it is in `opengame-characters`.
@@ -1,5 +1,9 @@
1
1
  # opengame-stability changelog
2
2
 
3
+ ## 1.1.0
4
+
5
+ New rules for a structural guard per crash class (OS), no late timer that moves the game and no silent fallback (OH, LC), one composite per frame (OH) and a fallback renderer booted on every default change (LC). The release gate now counts a recovery as a crash (OS), and the soak, watchdog, recovery and deploy rules carry OS, LC and OH numbers.
6
+
3
7
  ## 1.0.0
4
8
 
5
9
  First public release, in the opengamehq/opengame repository and the OpenGame CLI.