@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,5 +1,9 @@
1
1
  # opengame-accessibility changelog
2
2
 
3
+ ## 1.1.0
4
+
5
+ New rules for telling a visitor who cannot play why (OH) and a zero-HUD view that draws nothing (LC). Controller, remapping, sensitivity, reduced motion and keyboard rules gain LC's pad numbers, OH's swapping rebinds, calm look and second pause key, and OS's rule that a default binding never moves without the owner's word.
6
+
3
7
  ## 1.0.0
4
8
 
5
9
  First public release, in the opengamehq/opengame repository and the OpenGame CLI.
@@ -1,8 +1,8 @@
1
1
  ---
2
2
  name: opengame-accessibility
3
- description: Make a browser game playable by more people. Covers a controller that reaches every screen, remapping, sensitivity and field of view, subtitles and visual sound cues, colour never the only signal, limited flashes, reduced motion, keyboard menus and options proven in play. Use when the person asks about accessibility, gamepad support, colourblind modes, subtitles, remapping keys, motion sickness, photosensitivity, or menus that work with a keyboard or screen reader.
3
+ description: Make a browser game playable by more people. Covers telling a visitor who cannot play why, a controller that reaches every screen, remapping that swaps, sensitivity and field of view, subtitles and visual sound cues, a zero-HUD view, colour never the only signal, limited flashes, reduced motion and a calm look, and keyboard menus with a second pause key. Use when the person asks about accessibility, gamepads, colourblind modes, subtitles, remapping, motion sickness, flashing or a blank page.
4
4
  metadata:
5
- version: "1.0.0"
5
+ version: "1.1.0"
6
6
  ---
7
7
 
8
8
  # Accessibility
@@ -12,7 +12,9 @@ first four games had no subtitles or visual sound cues, so this skill also teach
12
12
  published guidance: WCAG 2.3.1 for flashes, the Game Accessibility Guidelines and the
13
13
  Xbox Accessibility Guidelines for controls, audio and vision. OC shipped an accessibility
14
14
  tab, subtitles and controller support, and its launch audit found every one of those
15
- options "unverified at runtime"; the last rule is for that.
15
+ options "unverified at runtime"; the last rule is for that. LC built full controller
16
+ support that no person ever played with a real pad, and OH's launch QA found phones and
17
+ browsers that met a dead prompt or a blank page.
16
18
 
17
19
  Rules carry five tags; `opengame-quality-bar` explains them and the game codes. Where
18
20
  none of our games set a value, the reference configuration says so.
@@ -20,71 +22,85 @@ none of our games set a value, the reference configuration says so.
20
22
  ## Rules
21
23
 
22
24
  ### A controller reaches everything
23
- - **Invariant:** With a gamepad connected, every screen, menu, setting and dialog can be reached and used with the pad alone, focus is always visible, and a connected pad never breaks the game.
24
- - **Technique:** Read pads through the standard mapping each frame. Drive menus by focus with four-way navigation that also works inside sliders, dropdowns and checkboxes. Show prompts for the device used last (keyboard, pad or touch). Offer sensitivity, layouts and deadzone calibration in settings. Test with a pad connected before boot and with one connected mid-game.
25
- - **Reference configuration:** OC's owner on controller support: "RSI that a few times because we always mess this up". His list: works everywhere, visible focus, four-way navigation on sliders, dropdowns and checkboxes, Default and Tactical layouts, sensitivity 1-10, deadzone calibration, calibration for Bluetooth lag, and consistent styling. It landed at R87-R89. In another game a connected pad crashed every frame.
25
+ - **Invariant:** With a gamepad connected, every screen, menu, setting and dialog can be reached and used with the pad alone, focus is always visible, prompts show the pad in hand, and a connected or unplugged pad never breaks the game.
26
+ - **Technique:** Read pads through the standard mapping each frame. Drive menus by focus with four-way navigation that also works inside sliders, dropdowns and checkboxes. Show prompts for the device used last (keyboard, pad or touch), decided by recent motion past the dead zone so a resting stick never takes over from the mouse, and tell makers apart by vendor and product id (see `opengame-front-end`). Offer sensitivity on a scale with a measured turn rate, a radial dead zone that rescales what is left, response curves, layouts stored as bindings, and calibration for Bluetooth lag. Swap accept and back on the maker that expects it. Unplugging pauses. Test with a pad connected before boot and with one connected mid-game.
27
+ - **Reference configuration:** OC's owner on controller support: "RSI that a few times because we always mess this up". The list: works everywhere, visible focus, four-way navigation on sliders, dropdowns and checkboxes, Default and Tactical layouts, sensitivity 1-10, deadzone calibration, calibration for Bluetooth lag, and consistent styling. It landed at R87-R89. In another game a connected pad crashed every frame. LC's owner asked for "world class controller support ... default/tactical support and menu navigation ... showing the right shortcuts based on whether its a ps5 or xbox controller ... default controller sensitivity 4/10". LC's sensitivity 4 turns 150°/s (filmed at 152.8-160), with a radial dead zone 0.10-0.99, a trigger point of 0.15, a 2.2 power curve among three curves, a 60% edge boost, and four layouts (Default, Tactical, Bumper Jumper, Left-handed). No browser exposes adaptive triggers. LC's pads were only ever scripted; nobody held one.
26
28
  - **Applies when:** Every game that runs on desktop, and every game whose genre players expect a pad.
27
- - **Verify:** After boot, put the mouse and keyboard away. With the pad alone, go from the title to a match, change three settings, pause, quit and confirm. Then reload with the pad already connected and do it again.
29
+ - **Verify:** After boot, put the mouse and keyboard away. With the pad alone, go from the title to a match, change three settings, pause, quit and confirm. Then reload with the pad already connected and do it again. Unplug it mid-match: the game pauses. Do this with a real pad of each maker you claim, not only a scripted one.
28
30
 
29
- ### Every control can be remapped
30
- - **Invariant:** Every gameplay action can be bound to a different key or button, conflicts are shown, and the bindings persist and are the ones the game reads.
31
- - **Technique:** One action table drives input, HUD hints, menu help and the remapping screen, so a remap updates every prompt. Offer hold or toggle for held actions (aim, crouch, sprint), and make every action reachable without a mouse.
32
- - **Reference configuration:** Not set by our first four games. ST keeps one action table for input handling, HUD hints, menu help and playtests, and its control defaults (WASD, mouse, F to interact, R to reload) are a starting table. OC offers hold or toggle for aim and crouch. At one OC commit rebinding was cosmetic: the docs said the player code read the saved bindings, and a reviewer found it did not.
31
+ ### A visitor who cannot play is told why, at once
32
+ - **Invariant:** No visitor meets a blank page or a prompt they cannot answer: a browser without the graphics API the game needs and a touch-only device for a game without touch controls each get a notice, in the game's own look, that names the reason and what to do.
33
+ - **Technique:** Probe for the API before the large download (`getContext('webgl2')`, or WebGPU as `opengame-mobile` describes) and wrap renderer construction in a try, so a failure lands on the notice rather than an empty page. Treat a device as touch-only when `matchMedia('(pointer: coarse)')` matches and `(any-pointer: fine)` does not, and never show "press any key" there. Offer what the visitor can do: open the link on a computer, update the browser, or turn on hardware acceleration.
34
+ - **Reference configuration:** OH's launch QA found that a phone sat for ever at PRESS ANY KEY and that a browser without WebGL 2 showed a blank page; both now show a notice drawn in the game's paper look. OS's "no mobile/touch" was a locked owner decision and LC is desktop-only by design, so for games like these the notice is the whole phone experience. OC's capability card is in `opengame-mobile`.
35
+ - **Applies when:** Every game that needs WebGL 2 or WebGPU, and every game without touch controls.
36
+ - **Verify:** Launch with WebGL 2 unavailable (an init script that makes `getContext('webgl2')` return null): the notice appears and nothing large downloads. Open the game in a touch-only context with a coarse pointer and no fine one, then on a real phone: the notice, never a dead prompt.
37
+
38
+ ### Every control can be remapped, and a rebind swaps
39
+ - **Invariant:** Every gameplay action can be bound to a different key or button, a key taken from another action swaps the two rather than leaving one action unbound or two on one key, the bindings persist, and they are the ones the game reads.
40
+ - **Technique:** One action table drives input, HUD hints, menu help and the remapping screen, so a remap updates every prompt. Offer hold or toggle for held actions (aim, crouch, sprint), and make every action reachable without a mouse. Read the bindings from the same store the settings screen writes (see `opengame-front-end` for one schema). A default binding moves only with the owner's decision, a changelog line and a save migration.
41
+ - **Reference configuration:** ST keeps one action table for input handling, HUD hints, menu help and playtests, and its control defaults (WASD, mouse, F to interact, R to reload) are a starting table. OC offers hold or toggle for aim and crouch. At one OC commit rebinding was cosmetic: the docs said the player code read the saved bindings, and a reviewer found it did not. OH's rebind gives the old key to the action that held the new one, after QA found two lanes sharing a key. OS's owner, after an agent moved E without asking: "also remember u need ot be able to eds with E as well! why did we remove that?" LC moved its light from F to T while giving F to interactions, without saying so, and the owner asked: "u should be able to turn off flashlight idk why that went away".
33
42
  - **Applies when:** Every game with more than a couple of inputs.
34
- - **Verify:** Rebind every action to a different key, restart the game, and complete the first objective with only the new keys.
43
+ - **Verify:** Rebind every action to a different key, restart the game, and complete the first objective with only the new keys. Bind one action to another's key: both still work, on swapped keys.
35
44
 
36
45
  ### Sensitivity and field of view are the player's
37
- - **Invariant:** Look sensitivity, axis inversion and field of view can be changed in settings, apply live, and persist.
38
- - **Technique:** Settings write straight through to the running game; field of view has a range wide enough for players who get motion sick at a narrow one. Camera shake, head bob and motion blur each have their own off switch.
39
- - **Reference configuration:** DK's world lens is 110 degrees with the weapon drawn at a fixed 75 in its own pass, so changing the world field of view never resizes the weapon. OC: field of view 80-120, a shake toggle, motion blur on by default with the gun kept sharp, touch aim assist 0-100.
46
+ - **Invariant:** Look sensitivity, axis inversion and field of view can be changed in settings, apply live, persist, and mean the same turn at any frame rate.
47
+ - **Technique:** Settings write straight through to the running game; field of view has a range wide enough for players who get motion sick at a narrow one. Show mouse sensitivity in physical units (centimetres per full turn at a stated mouse resolution) with a live tester. Camera shake, head bob and motion blur each have their own off switch. Why a camera ease reads as low sensitivity is in `opengame-game-feel`.
48
+ - **Reference configuration:** DK's world lens is 110 degrees with the weapon drawn at a fixed 75 in its own pass, so changing the world field of view never resizes the weapon. OC: field of view 80-120, a shake toggle, motion blur on by default with the gun kept sharp, touch aim assist 0-100. LC: 0.0022 rad a count, 9.1 cm per 360 at 800 cpi at 1.00x, with invert Y; 1,428 counts turn exactly 180 degrees at 60, 30, 15 and 8 fps.
40
49
  - **Applies when:** First-person and third-person 3D games.
41
- - **Verify:** Change each setting during play and see it take effect without a restart; reload and see it kept.
50
+ - **Verify:** Change each setting during play and see it take effect without a restart; reload and see it kept. Turn by a fixed count of real input at two frame rates: the angle is the same.
42
51
 
43
52
  ### Important sounds are also seen
44
53
  - **Invariant:** Anything a player must hear to play well (speech, a threat behind them, an objective cue) also appears on screen.
45
54
  - **Technique:** Subtitles for every line of speech, with speaker names, readable size and a background; directional visual indicators for important off-screen sounds; captions for important non-speech sounds. Drive them from the same cue registry as the audio so none is missed. A subtitle lasts as long as its clip and closes when the line is cut off.
46
- - **Reference configuration:** None of DK, MC, AW or SR has subtitles or visual sound cues. OC subtitles every line, "not super big... but still visible" in the owner's words: at least 10 pt on a phone 375 pt tall, in a band 6% from the bottom no wider than 42% of the screen, drawn above menus. Outside guidance: subtitles on by default or offered at first launch, large enough to read at a living-room distance, never covering the centre of the screen.
55
+ - **Reference configuration:** None of DK, MC, AW or SR has subtitles or visual sound cues. OC subtitles every line, "not super big... but still visible" in the owner's words: at least 10 pt on a phone 375 pt tall, in a band 6% from the bottom no wider than 42% of the screen, drawn above menus. LC offers subtitles with a size setting and shows a blow's direction as the heaviest screen edge for 0.8 s. Outside guidance: subtitles on by default or offered at first launch, large enough to read at a living-room distance, never covering the centre of the screen.
47
56
  - **Applies when:** Every game with speech or with sound that carries gameplay information.
48
57
  - **Verify:** Play the first ten minutes muted; every voice line and every threat the player needed to react to was shown.
49
58
 
59
+ ### Zero HUD is zero, named in the player's words
60
+ - **Invariant:** A "no HUD" setting draws nothing on the picture, not subtitles and not toasts, is easy to find and can be toggled in play, and what remains on screen is only what belongs to the camera.
61
+ - **Technique:** Name the setting the way the owner or players ask for it, put it first on the tab Settings opens to, and give it a key. When it is off, never write subtitles, never raise toasts, and pause tutorials without counting them as taught. Keep separate toggles for single aids such as a way-finding arrow. Check it by counting rendered HUD elements, not by eye.
62
+ - **Reference configuration:** LC's owner asked for "a 0 hud view (where there is no hud at all no even commentator subtitles)" and a way to turn off the arrow, then: "wheres ability to turn off hud btw in settings?" It existed and could not be found, so it was renamed in the owner's words, made the first row and given the H key. Off, it draws 0 elements in 16 states (27-31 with the HUD) and 0 in 65 readings through a death; the hurt rim stays, because it belongs to the camera.
63
+ - **Applies when:** Every game with a HUD, and every game a trailer will be cut from.
64
+ - **Verify:** With the setting off, count rendered HUD elements in every state, including a death, a subtitle line and a toast: zero. Toggle it with its key mid-fight.
65
+
50
66
  ### Colour is never the only signal
51
67
  - **Invariant:** Every state shown with colour (team, rarity, selection, damage type, danger) is also shown by shape, icon, text or position, and a colour keeps one meaning across the whole game.
52
68
  - **Technique:** Pair each colour with a second channel and check the palette under colour-vision simulations; keep text and important icons above contrast minimums against what is behind them. Write down what each gameplay colour means and check every glow, marker and bar against it.
53
- - **Reference configuration:** SR's design rule: a state has a shape, so its yellow selection always comes with an underline, size, rank position or focus outline. Contrast floors from WCAG: 4.5:1 for body text, 3:1 for large text. OC: orange means immune and cyan or violet means shoot here; a baked glow once said "shoot here" while the health bar said immune. OC ships a colour-blind palette.
69
+ - **Reference configuration:** SR's design rule: a state has a shape, so its yellow selection always comes with an underline, size, rank position or focus outline. Contrast floors from WCAG: 4.5:1 for body text, 3:1 for large text. OC: orange means immune and cyan or violet means shoot here; a baked glow once said "shoot here" while the health bar said immune. OC ships a colour-blind palette. LC tells its perk icons apart by shape.
54
70
  - **Applies when:** Every game.
55
71
  - **Verify:** Capture the HUD and menus through protanopia, deuteranopia and tritanopia simulations and in greyscale; every state is still distinguishable.
56
72
 
57
73
  ### Flashes are limited at the source
58
74
  - **Invariant:** No effect makes the screen's brightness change quickly enough or often enough, rising or falling, to count as a photosensitive flash.
59
75
  - **Technique:** Bound the frame-to-frame change of composited luminance for full-screen effects in both directions, discovered by measuring every large overlay rather than reading a list, and bound how many large flashes can happen in a second. Offer a setting that reduces every flash further. Prefer fades to cuts for whole-screen changes, and ease any light that flickers at random.
60
- - **Reference configuration:** AW limits each overlay's frame-to-frame luminance step to 0.045, under half of WCAG 2.3.1's 0.10 flash pair, after two players reported flashing violent enough to fear a seizure; its budgets allow zero steps over that limit. OC: at most 3 full-frame flashes a second and no 10-11 Hz strobe; Reduce Flashing scales every flash to 20% and removes the boss's 12 Hz wind-up blink; the storm light flickered at random near 11 Hz and needed easing. OC's new lightning cut the flat-white share of a first-person frame from 10.47% to 0.58%.
76
+ - **Reference configuration:** AW limits each overlay's frame-to-frame luminance step to 0.045, under half of WCAG 2.3.1's 0.10 flash pair, after two players reported flashing violent enough to fear a seizure; its budgets allow zero steps over that limit. OC: at most 3 full-frame flashes a second and no 10-11 Hz strobe; Reduce Flashing scales every flash to 20% and removes the boss's 12 Hz wind-up blink; the storm light flickered at random near 11 Hz and needed easing. OC's new lightning cut the flat-white share of a first-person frame from 10.47% to 0.58%. LC offers Reduce Flashing and also reads `prefers-reduced-motion`.
61
77
  - **Applies when:** Every game with flashes, explosions, damage effects or lightning.
62
78
  - **Verify:** Record the worst flash in the game (an explosion at point blank, a lightning strike) and compute per-frame mean luminance; no step exceeds the limit and no second holds more large flashes than the limit. Repeat with Reduce Flashing on.
63
79
 
64
- ### Reduced motion is honoured
65
- - **Invariant:** When the player asks for less motion (in the game or through the operating system's preference), decorative motion stops and every piece of information it carried is still shown.
66
- - **Technique:** Read `prefers-reduced-motion` and a game setting; replace menu films with their posters, remove parallax, shake and bob, and swap animated transitions for fades, while keeping a stable cue for every state change.
67
- - **Reference configuration:** AW gates its menu films on reduced motion; ST shows the static poster with no autoplay and keeps a stable information cue in place of motion. In OC, reduced motion keeps the directional hit cues and drops the camera kick.
80
+ ### Reduced motion and a calm look are honoured
81
+ - **Invariant:** When the player asks for less motion, through the operating system or the game's own calm setting, decorative motion is removed rather than frozen, and every piece of information it carried is still shown.
82
+ - **Technique:** Read `prefers-reduced-motion` and a game setting, and offer the calm setting even when the system preference is off. Replace menu films with their stills, remove parallax, shake, bob and drifting backgrounds, swap animated transitions for fades, remove moving layers of menu effects rather than freezing them mid-frame, and still the world's flashes, while keeping a stable cue for every state change.
83
+ - **Reference configuration:** AW gates its menu films on reduced motion; ST shows the static poster with no autoplay and keeps a stable information cue in place of motion. In OC, reduced motion keeps the directional hit cues and drops the camera kick. OH's Calm look stills the stage's drift and its flashes while the board and its cues stay. LC's reduced motion removes its tape layers instead of freezing them.
68
84
  - **Applies when:** Every game with decorative motion.
69
- - **Verify:** Turn on reduced motion in the operating system, reload, and walk the menus and the first minute of play: no film plays, nothing shakes, and nothing that mattered disappeared.
85
+ - **Verify:** Turn on reduced motion in the operating system, reload, and walk the menus and the first minute of play: no film plays, nothing shakes or drifts, and nothing that mattered disappeared. Repeat with only the game's calm setting on.
70
86
 
71
- ### Menus work from the keyboard, and read correctly
72
- - **Invariant:** Every menu and dialog works with the keyboard alone, focus is always visible and lands somewhere sensible, and controls have real names.
73
- - **Technique:** Real buttons and form controls, a visible focus style, Tab order that follows the layout, Escape for back, focus moved into a dialog on open and restored on close, and background controls made unreachable while a dialog is open.
74
- - **Reference configuration:** ST's front-end rules: Enter and Space activate the focused action, modal settings and pause contain focus, menus reflow at 200% zoom without clipped actions.
87
+ ### Menus work from the keyboard, read correctly, and pause has a second key
88
+ - **Invariant:** Every menu and dialog works with the keyboard alone, focus is always visible and lands somewhere sensible, controls have real names, and pause still works when the browser or a host page takes Escape.
89
+ - **Technique:** Real buttons and form controls, a visible focus style, Tab order that follows the layout, Escape for back, focus moved into a dialog on open and restored on close, and background controls made unreachable while a dialog is open. Give pause a second key beside Escape, because a browser leaving fullscreen or a host page in fullscreen spends Escape before the game sees it.
90
+ - **Reference configuration:** ST's front-end rules: Enter and Space activate the focused action, modal settings and pause contain focus, menus reflow at 200% zoom without clipped actions. OH pauses on P as well as Escape, because a host in fullscreen takes Escape. LC makes destructive actions holds, or a click that arms and a second that confirms.
75
91
  - **Applies when:** Every game.
76
- - **Verify:** Unplug the mouse and walk title, settings, pause, results and retry; then run an automated accessibility scan of each menu.
92
+ - **Verify:** Unplug the mouse and walk title, settings, pause, results and retry; then run an automated accessibility scan of each menu. In fullscreen, pause with the second key.
77
93
 
78
94
  ### Difficulty and timing can be adjusted
79
95
  - **Invariant:** A player who cannot react as fast or press as accurately as the default assumes can still progress.
80
96
  - **Technique:** Offer options that change timing windows, game speed, aim assistance or damage taken, with labels that say what each one changes, without locking content behind the default.
81
- - **Reference configuration:** Not set by our games. Outside guidance recommends offering a range of difficulty and the ability to slow the game.
97
+ - **Reference configuration:** Outside guidance recommends offering a range of difficulty and the ability to slow the game. LC offers aim help off, standard and strong. A rhythm game's timing windows and latency calibration are in `opengame-rhythm`.
82
98
  - **Applies when:** Games with timing-heavy challenges.
83
99
  - **Verify:** Complete the first objective at the most assisted setting with slow, imprecise input.
84
100
 
85
101
  ### Every option is proven in play, on and off
86
102
  - **Invariant:** Each accessibility and comfort option changes what it says it changes in a real run, both ways, and survives a reload.
87
- - **Technique:** For each option, record the same moment of play with it on and off and compare: a lightning strike with Reduce Flashing, a voice line with subtitles, a hit with shake off, a remapped key in a match. Save, reload and check the value, including off and zero. New movement or control features ship as saved toggles with a sensible default. Persistence rules are in `opengame-front-end`.
88
- - **Reference configuration:** At OC's launch audit, volume, sensitivity, field of view, rebinding, the colour-blind palette, Reduce Flashing and subtitle size all existed and were all "unverified at runtime"; Reduce Flashing had never been checked by eye. OC's chained jumps ship on by default, and off persists.
103
+ - **Technique:** For each option, record the same moment of play with it on and off and compare: a lightning strike with Reduce Flashing, a voice line with subtitles, a hit with shake off, a remapped key in a match, a death with zero HUD. Save, reload and check the value, including off and zero. New movement or control features ship as saved toggles with a sensible default. Persistence rules are in `opengame-front-end`.
104
+ - **Reference configuration:** At OC's launch audit, volume, sensitivity, field of view, rebinding, the colour-blind palette, Reduce Flashing and subtitle size all existed and were all "unverified at runtime"; Reduce Flashing had never been checked by eye. OC's chained jumps ship on by default, and off persists. LC shipped Reduce Flashing, subtitles with size, invert Y, hold-to-confirm, an aiming dot off by default, a brightness card on the renderer's own curve, 2^((b - 0.5) x 1.6), aim help and shape-coded perk icons; its zero-HUD setting was proven by element count, and none of its pad options was tried by a person.
89
105
  - **Applies when:** Every game with an accessibility or settings menu.
90
106
  - **Verify:** A table with one row per option: an on clip, an off clip and a reload check, each linked.
@@ -0,0 +1,25 @@
1
+ # opengame-all-in-one changelog
2
+
3
+ ## 1.0.5
4
+
5
+ Carries `opengame-api` 1.0.8, `opengame-cli` 1.9.0, `opengame-deploy` 1.1.7 and `opengame-jam` 1.1.0, which publish with `opengame publish` (16 Nov 2026).
6
+
7
+ ## 1.0.4
8
+
9
+ Carries opengame-performance 1.1.1 and opengame-scene-audit 1.1.1.
10
+
11
+ ## 1.0.3
12
+
13
+ Carries opengame-deploy 1.1.6.
14
+
15
+ ## 1.0.2
16
+
17
+ Carries opengame-multiplayer 1.1.0, opengame-sdk 1.0.13 and opengame-deploy 1.1.5: invite links that open the game on OpenGame, and PeerJS and game servers set up for it.
18
+
19
+ ## 1.0.1
20
+
21
+ Carries opengame-api 1.0.7, opengame-characters 1.2.1, opengame-cli 1.8.4, opengame-deploy 1.1.4, opengame-jam 1.0.9 and opengame-sdk 1.0.12.
22
+
23
+ ## 1.0.0
24
+
25
+ The first release: every OpenGame skill carried whole under `references/`, with the route through them from a first playable to a trailer and a montage.
@@ -0,0 +1,195 @@
1
+ ---
2
+ name: opengame-all-in-one
3
+ description: Every OpenGame skill in one install, with the order to use them in, for taking a browser game from an idea to a AAA-feeling release, a trailer and a montage. Carries the platform, craft and video skills whole. Use when someone wants one skill that covers everything, says make it AAA or make it game of the year, starts a big game with agents, or does not know which OpenGame skill to load.
4
+ metadata:
5
+ version: "1.0.5"
6
+ ---
7
+
8
+ # Make a browser game that feels AAA
9
+
10
+ This skill carries every other OpenGame skill, each whole, under `references/`. Nothing
11
+ here replaces them: it is the route through them, in the order the work happens, and the
12
+ lessons that held across every game we pushed hardest. Read a carried skill when its step
13
+ comes up, not all of them at once.
14
+
15
+ **How to read a carried skill.** When one names another skill, such as `opengame-deploy`,
16
+ it is here at `references/opengame-deploy/README.md`; you do not need it installed. A path
17
+ inside a carried skill, such as references/threejs.md or helpers/spring.js, starts from
18
+ that skill's own folder, so the spring helper in `opengame-game-feel` is
19
+ `references/opengame-game-feel/helpers/spring.js`.
20
+
21
+ The lessons come from our own games, named by the codes in
22
+ [the quality bar](references/opengame-quality-bar/README.md): OG Clash (OC), a wave shooter
23
+ with a boss; OG Snipers (OS), a snipers-only multiplayer shooter with bots, about 500 builds
24
+ in 13 days; Last Contact (LC), a body-cam survival horror shooter built by up to ten agent
25
+ streams over six days; OG Hero (OH), a painterly rhythm game with 169 songs written in code. None of them
26
+ was finished by the first idea of what finished meant, and most of what cost them days is
27
+ written below so it costs you minutes.
28
+
29
+ ## The bar, before anything is built
30
+
31
+ - A stranger decides in ninety seconds. A game feels AAA less because of content and more
32
+ because the route a new player walks (title, menu, first minute, loading) has no cheap
33
+ tells. [The quality bar](references/opengame-quality-bar/README.md) lists them.
34
+ - Turn the owner's reference (concept art, a concept film, a named shipped game) into
35
+ written statements a stranger could mark pass or fail: the lens, how exposure behaves,
36
+ where light comes from, the palette, the hands, the HUD. "Make it look like the video"
37
+ is not a target; "with nothing lit, the night is black, not dusk blue" is.
38
+ - When the owner names a reference, measure it and match its numbers before tuning by
39
+ adjective. LC read "a bit trippy" as a dial, shipped three stronger versions, and was
40
+ told "way too aggressive"; matching the reference's numbers ended it.
41
+ - Write down what the owner asked for, in their words, and keep every later note beside
42
+ it, ranked by how often it was repeated.
43
+
44
+ ## The route
45
+
46
+ Work in this order. Each step names the carried skill that holds its rules.
47
+
48
+ 1. **Brief and bar.** Genre, camera, the one thing only this game does, the reference
49
+ frames, the budget. Then the first playable: the core loop with placeholder art, before
50
+ any polish. ([quality bar](references/opengame-quality-bar/README.md),
51
+ [depth](references/opengame-depth/README.md))
52
+ 2. **Production setup.** A lead, owned file areas, a written contract between them, status
53
+ files, an ask register, rounds that end in captures, and a reviewer with fresh context.
54
+ ([production](references/opengame-production/README.md),
55
+ [verification](references/opengame-verification/README.md))
56
+ 3. **The world reads.** Light, colour, fog and post; geometry that holds up close; maps
57
+ whose collision is exactly what is drawn. ([look](references/opengame-look/README.md),
58
+ [lighting](references/opengame-lighting/README.md),
59
+ [scene audit](references/opengame-scene-audit/README.md),
60
+ [world physics](references/opengame-world-physics/README.md),
61
+ [maps](references/opengame-maps/README.md))
62
+ 4. **It feels good to play.** Input, camera, hits, recoil, then the weapons and enemies
63
+ that use them, and the pacing in the player's own unit.
64
+ ([game feel](references/opengame-game-feel/README.md),
65
+ [weapons](references/opengame-weapons/README.md),
66
+ [enemies](references/opengame-enemies/README.md),
67
+ [rhythm](references/opengame-rhythm/README.md) for music games)
68
+ 5. **Characters and assets.** Bodies, rigs, motion, models, textures, sound, each seen in
69
+ the running game before it counts. ([characters](references/opengame-characters/README.md),
70
+ [assets](references/opengame-assets/README.md),
71
+ [audio](references/opengame-audio/README.md))
72
+ 6. **Other players.** Lobbies, rooms, bots that read as people.
73
+ ([multiplayer](references/opengame-multiplayer/README.md),
74
+ [SDK](references/opengame-sdk/README.md))
75
+ 7. **The front end.** Title, menus, loading, HUD, settings, controllers.
76
+ ([front end](references/opengame-front-end/README.md),
77
+ [accessibility](references/opengame-accessibility/README.md))
78
+ 8. **Fast and solid.** Frame-time budgets, first and second loads, phones, crashes.
79
+ ([performance](references/opengame-performance/README.md),
80
+ [loading](references/opengame-loading/README.md),
81
+ [mobile](references/opengame-mobile/README.md),
82
+ [stability](references/opengame-stability/README.md))
83
+ 9. **Judge it like a stranger.** Captures from the real route, the cheap tells, blunt
84
+ scores against the bar, the owner's own path. ([quality bar](references/opengame-quality-bar/README.md),
85
+ [capture](references/opengame-capture/README.md),
86
+ [verification](references/opengame-verification/README.md))
87
+ 10. **Ship it on OpenGame.** ([router](references/opengame-router/README.md),
88
+ [SDK](references/opengame-sdk/README.md),
89
+ [deploy](references/opengame-deploy/README.md),
90
+ [CLI](references/opengame-cli/README.md),
91
+ [API](references/opengame-api/README.md),
92
+ [jam](references/opengame-jam/README.md))
93
+ 11. **Film it.** A launch trailer and a gameplay montage, each planned, made and reviewed
94
+ in rounds. ([trailer plan](references/opengame-trailer-plan/README.md),
95
+ [trailer make](references/opengame-trailer-make/README.md),
96
+ [trailer review](references/opengame-trailer-review-and-improve/README.md),
97
+ [montage plan](references/opengame-montage-plan/README.md),
98
+ [montage make](references/opengame-montage-make/README.md),
99
+ [montage review](references/opengame-montage-review-and-improve/README.md))
100
+
101
+ Steps 3 to 8 are not a waterfall. Each round touches several; when two compete, fix the
102
+ core loop first, then every generated asset, then the front end, then playtest.
103
+
104
+ ## What every one of our games learned the hard way
105
+
106
+ **Proof**
107
+ - **The owner finds what your checks miss, so build checks that see the way the owner
108
+ does.** On OS the owner found about 93% of new defects. Each class the owner reports gets
109
+ an instrument that would have caught it.
110
+ - **Judge the build the owner plays, on the owner's path.** Saved settings, a return visit,
111
+ a window size, a slow line, real keys, strict autoplay. Every complaint LC heard four
112
+ times lived on a path nobody had tested. New looks sit behind a flag until a capture of
113
+ the default build proves them.
114
+ - **Prove the instrument before believing its number.** OS and LC each acted on numbers the
115
+ measuring tool itself produced: warm "cold" boots, culled scenes counted as optimised, a
116
+ read-back that slowed the frame it timed. Plant a defect; a check that cannot fail it is
117
+ not a check.
118
+ - **Motion is judged on video, at quarter speed, never on stills.** Panels of stills scored
119
+ OS 3 to 4 for about 135 builds while the owner reported flicker and shake.
120
+ - **Hide one thing at a time before mending.** The obvious cause was usually wrong; one
121
+ ablation found the real owner of the fault in two short jobs.
122
+ - **Agents cannot hear and cannot watch at speed.** Say "measured", never "heard", and get
123
+ a person to listen and play before calling sound or motion right.
124
+
125
+ **Fixes**
126
+ - **Sweep the class, not the instance.** When the owner names one bad gun, prop or pose,
127
+ find every other member of that class before replying.
128
+ - **Every fix names the neighbour it could break.** Fixes caused the next defect about 25
129
+ times in five days on OS. Lower, softer, darker and louder each need a check from the
130
+ player's own view.
131
+ - **Freeze what the owner approves.** Archive approved looks and diff every later change
132
+ against them; judge advice and parity passes broke an approved scope, camo and hands.
133
+ - **When gains stall, change the method, not the polish.** Seven repaints of OH's world
134
+ gained little; one rebuild on the reference's own method gained more than all of them.
135
+
136
+ **Assets**
137
+ - **See every generated thing in the running game before it counts.**
138
+ - **Generated hard surfaces top out at passable.** LC spent most of its generation budget
139
+ before learning that none of 73 generated guns reached photoreal. Use licensed artists'
140
+ models for what the player holds; generate bodies, far props and variety; grade every
141
+ generated material; prove one asset route end to end before buying a batch.
142
+ - **If the content must match something, own the thing it matches.** OH spent 26 hours
143
+ charting recordings and never passed "2 or 3/10"; the first song it composed and charted
144
+ from its own notes was "great chart".
145
+
146
+ **People and machines**
147
+ - **Keep the owner's words.** Quote notes exactly. A paraphrase that strengthens or softens
148
+ a note produces the wrong fix. Never answer a content complaint with a setup step.
149
+ - **Every picture you send is the owner's next review.** Name its flaws in its caption.
150
+ - **Never block on the owner.** One synchronous question idled fifteen agents for hours on
151
+ OS. Decide, write the decision and its reason, and go on.
152
+ - **Design for loss.** Outages took about 37 of 98 hours on LC and 36 of 67 on OH. Only
153
+ state in commits, docs and handover notes survived; keep nothing that matters in a
154
+ session.
155
+ - **Size the team to what you have.** Too many agents on one model pool tripped account-wide
156
+ rate limits on LC; too few job slots left agents queueing for captures and committing
157
+ from unit tests alone.
158
+
159
+ ## Which carried skill answers what
160
+
161
+ | Question | Read |
162
+ | --- | --- |
163
+ | Is it good enough, what is missing | [quality bar](references/opengame-quality-bar/README.md) |
164
+ | Rules, goals, progression, balance | [depth](references/opengame-depth/README.md) |
165
+ | Light, colour, fog, post | [look](references/opengame-look/README.md), [lighting](references/opengame-lighting/README.md) |
166
+ | Geometry, props, collision | [scene audit](references/opengame-scene-audit/README.md), [world physics](references/opengame-world-physics/README.md) |
167
+ | Maps, spawns, sightlines | [maps](references/opengame-maps/README.md) |
168
+ | Floaty, stiff, hits do not land, kill cams | [game feel](references/opengame-game-feel/README.md) |
169
+ | Guns, sights, viewmodels, reloads | [weapons](references/opengame-weapons/README.md) |
170
+ | Enemy AI, hordes, bosses, bots | [enemies](references/opengame-enemies/README.md) |
171
+ | Characters, rigs, first-person bodies | [characters](references/opengame-characters/README.md) |
172
+ | A rhythm or music game | [rhythm](references/opengame-rhythm/README.md) |
173
+ | Lobbies and other players | [multiplayer](references/opengame-multiplayer/README.md) |
174
+ | Models, textures, generated assets | [assets](references/opengame-assets/README.md) |
175
+ | Sound and music | [audio](references/opengame-audio/README.md) |
176
+ | Title, menus, HUD, controllers | [front end](references/opengame-front-end/README.md) |
177
+ | Keyboard, focus, reduced motion | [accessibility](references/opengame-accessibility/README.md) |
178
+ | Frame time and memory | [performance](references/opengame-performance/README.md) |
179
+ | Boot time and caching | [loading](references/opengame-loading/README.md) |
180
+ | Phones and touch | [mobile](references/opengame-mobile/README.md) |
181
+ | Crashes and error reports | [stability](references/opengame-stability/README.md) |
182
+ | Tests and proof | [verification](references/opengame-verification/README.md) |
183
+ | Screenshots and filming | [capture](references/opengame-capture/README.md) |
184
+ | Long builds with agents and rounds of notes | [production](references/opengame-production/README.md) |
185
+ | Which skill for a task | [router](references/opengame-router/README.md) |
186
+ | The SDK in the frame | [SDK](references/opengame-sdk/README.md) |
187
+ | Check, deploy, preview | [deploy](references/opengame-deploy/README.md), [CLI](references/opengame-cli/README.md) |
188
+ | Your own tools and CI | [API](references/opengame-api/README.md) |
189
+ | Jam fields and eligibility | [jam](references/opengame-jam/README.md) |
190
+ | A launch trailer | [plan](references/opengame-trailer-plan/README.md), [make](references/opengame-trailer-make/README.md), [review](references/opengame-trailer-review-and-improve/README.md) |
191
+ | A gameplay montage | [plan](references/opengame-montage-plan/README.md), [make](references/opengame-montage-make/README.md), [review](references/opengame-montage-review-and-improve/README.md) |
192
+
193
+ Each carried skill says, in its first line, the version it was carried at. The separate
194
+ skills are the same text, so install this one or those, not both: `opengame skills add
195
+ --all` leaves this one out for that reason.
@@ -0,0 +1,102 @@
1
+ > Carried from `opengame-accessibility` 1.1.0. Read it when: Make a browser game playable by more people. Covers telling a visitor who cannot play why, a controller that reaches every screen, remapping that swaps, sensitivity and field of view, subtitles and visual sound cues, a zero-HUD view, colour never the only signal, limited flashes, reduced motion and a calm look, and keyboard menus with a second pause key. Use when the person asks about accessibility, gamepads, colourblind modes, subtitles, remapping, motion sickness, flashing or a blank page.
2
+
3
+
4
+ # Accessibility
5
+
6
+ Most of this costs little when it is designed in and a lot when it is retrofitted. Our
7
+ first four games had no subtitles or visual sound cues, so this skill also teaches from
8
+ published guidance: WCAG 2.3.1 for flashes, the Game Accessibility Guidelines and the
9
+ Xbox Accessibility Guidelines for controls, audio and vision. OC shipped an accessibility
10
+ tab, subtitles and controller support, and its launch audit found every one of those
11
+ options "unverified at runtime"; the last rule is for that. LC built full controller
12
+ support that no person ever played with a real pad, and OH's launch QA found phones and
13
+ browsers that met a dead prompt or a blank page.
14
+
15
+ Rules carry five tags; `opengame-quality-bar` explains them and the game codes. Where
16
+ none of our games set a value, the reference configuration says so.
17
+
18
+ ## Rules
19
+
20
+ ### A controller reaches everything
21
+ - **Invariant:** With a gamepad connected, every screen, menu, setting and dialog can be reached and used with the pad alone, focus is always visible, prompts show the pad in hand, and a connected or unplugged pad never breaks the game.
22
+ - **Technique:** Read pads through the standard mapping each frame. Drive menus by focus with four-way navigation that also works inside sliders, dropdowns and checkboxes. Show prompts for the device used last (keyboard, pad or touch), decided by recent motion past the dead zone so a resting stick never takes over from the mouse, and tell makers apart by vendor and product id (see `opengame-front-end`). Offer sensitivity on a scale with a measured turn rate, a radial dead zone that rescales what is left, response curves, layouts stored as bindings, and calibration for Bluetooth lag. Swap accept and back on the maker that expects it. Unplugging pauses. Test with a pad connected before boot and with one connected mid-game.
23
+ - **Reference configuration:** OC's owner on controller support: "RSI that a few times because we always mess this up". The list: works everywhere, visible focus, four-way navigation on sliders, dropdowns and checkboxes, Default and Tactical layouts, sensitivity 1-10, deadzone calibration, calibration for Bluetooth lag, and consistent styling. It landed at R87-R89. In another game a connected pad crashed every frame. LC's owner asked for "world class controller support ... default/tactical support and menu navigation ... showing the right shortcuts based on whether its a ps5 or xbox controller ... default controller sensitivity 4/10". LC's sensitivity 4 turns 150°/s (filmed at 152.8-160), with a radial dead zone 0.10-0.99, a trigger point of 0.15, a 2.2 power curve among three curves, a 60% edge boost, and four layouts (Default, Tactical, Bumper Jumper, Left-handed). No browser exposes adaptive triggers. LC's pads were only ever scripted; nobody held one.
24
+ - **Applies when:** Every game that runs on desktop, and every game whose genre players expect a pad.
25
+ - **Verify:** After boot, put the mouse and keyboard away. With the pad alone, go from the title to a match, change three settings, pause, quit and confirm. Then reload with the pad already connected and do it again. Unplug it mid-match: the game pauses. Do this with a real pad of each maker you claim, not only a scripted one.
26
+
27
+ ### A visitor who cannot play is told why, at once
28
+ - **Invariant:** No visitor meets a blank page or a prompt they cannot answer: a browser without the graphics API the game needs and a touch-only device for a game without touch controls each get a notice, in the game's own look, that names the reason and what to do.
29
+ - **Technique:** Probe for the API before the large download (`getContext('webgl2')`, or WebGPU as `opengame-mobile` describes) and wrap renderer construction in a try, so a failure lands on the notice rather than an empty page. Treat a device as touch-only when `matchMedia('(pointer: coarse)')` matches and `(any-pointer: fine)` does not, and never show "press any key" there. Offer what the visitor can do: open the link on a computer, update the browser, or turn on hardware acceleration.
30
+ - **Reference configuration:** OH's launch QA found that a phone sat for ever at PRESS ANY KEY and that a browser without WebGL 2 showed a blank page; both now show a notice drawn in the game's paper look. OS's "no mobile/touch" was a locked owner decision and LC is desktop-only by design, so for games like these the notice is the whole phone experience. OC's capability card is in `opengame-mobile`.
31
+ - **Applies when:** Every game that needs WebGL 2 or WebGPU, and every game without touch controls.
32
+ - **Verify:** Launch with WebGL 2 unavailable (an init script that makes `getContext('webgl2')` return null): the notice appears and nothing large downloads. Open the game in a touch-only context with a coarse pointer and no fine one, then on a real phone: the notice, never a dead prompt.
33
+
34
+ ### Every control can be remapped, and a rebind swaps
35
+ - **Invariant:** Every gameplay action can be bound to a different key or button, a key taken from another action swaps the two rather than leaving one action unbound or two on one key, the bindings persist, and they are the ones the game reads.
36
+ - **Technique:** One action table drives input, HUD hints, menu help and the remapping screen, so a remap updates every prompt. Offer hold or toggle for held actions (aim, crouch, sprint), and make every action reachable without a mouse. Read the bindings from the same store the settings screen writes (see `opengame-front-end` for one schema). A default binding moves only with the owner's decision, a changelog line and a save migration.
37
+ - **Reference configuration:** ST keeps one action table for input handling, HUD hints, menu help and playtests, and its control defaults (WASD, mouse, F to interact, R to reload) are a starting table. OC offers hold or toggle for aim and crouch. At one OC commit rebinding was cosmetic: the docs said the player code read the saved bindings, and a reviewer found it did not. OH's rebind gives the old key to the action that held the new one, after QA found two lanes sharing a key. OS's owner, after an agent moved E without asking: "also remember u need ot be able to eds with E as well! why did we remove that?" LC moved its light from F to T while giving F to interactions, without saying so, and the owner asked: "u should be able to turn off flashlight idk why that went away".
38
+ - **Applies when:** Every game with more than a couple of inputs.
39
+ - **Verify:** Rebind every action to a different key, restart the game, and complete the first objective with only the new keys. Bind one action to another's key: both still work, on swapped keys.
40
+
41
+ ### Sensitivity and field of view are the player's
42
+ - **Invariant:** Look sensitivity, axis inversion and field of view can be changed in settings, apply live, persist, and mean the same turn at any frame rate.
43
+ - **Technique:** Settings write straight through to the running game; field of view has a range wide enough for players who get motion sick at a narrow one. Show mouse sensitivity in physical units (centimetres per full turn at a stated mouse resolution) with a live tester. Camera shake, head bob and motion blur each have their own off switch. Why a camera ease reads as low sensitivity is in `opengame-game-feel`.
44
+ - **Reference configuration:** DK's world lens is 110 degrees with the weapon drawn at a fixed 75 in its own pass, so changing the world field of view never resizes the weapon. OC: field of view 80-120, a shake toggle, motion blur on by default with the gun kept sharp, touch aim assist 0-100. LC: 0.0022 rad a count, 9.1 cm per 360 at 800 cpi at 1.00x, with invert Y; 1,428 counts turn exactly 180 degrees at 60, 30, 15 and 8 fps.
45
+ - **Applies when:** First-person and third-person 3D games.
46
+ - **Verify:** Change each setting during play and see it take effect without a restart; reload and see it kept. Turn by a fixed count of real input at two frame rates: the angle is the same.
47
+
48
+ ### Important sounds are also seen
49
+ - **Invariant:** Anything a player must hear to play well (speech, a threat behind them, an objective cue) also appears on screen.
50
+ - **Technique:** Subtitles for every line of speech, with speaker names, readable size and a background; directional visual indicators for important off-screen sounds; captions for important non-speech sounds. Drive them from the same cue registry as the audio so none is missed. A subtitle lasts as long as its clip and closes when the line is cut off.
51
+ - **Reference configuration:** None of DK, MC, AW or SR has subtitles or visual sound cues. OC subtitles every line, "not super big... but still visible" in the owner's words: at least 10 pt on a phone 375 pt tall, in a band 6% from the bottom no wider than 42% of the screen, drawn above menus. LC offers subtitles with a size setting and shows a blow's direction as the heaviest screen edge for 0.8 s. Outside guidance: subtitles on by default or offered at first launch, large enough to read at a living-room distance, never covering the centre of the screen.
52
+ - **Applies when:** Every game with speech or with sound that carries gameplay information.
53
+ - **Verify:** Play the first ten minutes muted; every voice line and every threat the player needed to react to was shown.
54
+
55
+ ### Zero HUD is zero, named in the player's words
56
+ - **Invariant:** A "no HUD" setting draws nothing on the picture, not subtitles and not toasts, is easy to find and can be toggled in play, and what remains on screen is only what belongs to the camera.
57
+ - **Technique:** Name the setting the way the owner or players ask for it, put it first on the tab Settings opens to, and give it a key. When it is off, never write subtitles, never raise toasts, and pause tutorials without counting them as taught. Keep separate toggles for single aids such as a way-finding arrow. Check it by counting rendered HUD elements, not by eye.
58
+ - **Reference configuration:** LC's owner asked for "a 0 hud view (where there is no hud at all no even commentator subtitles)" and a way to turn off the arrow, then: "wheres ability to turn off hud btw in settings?" It existed and could not be found, so it was renamed in the owner's words, made the first row and given the H key. Off, it draws 0 elements in 16 states (27-31 with the HUD) and 0 in 65 readings through a death; the hurt rim stays, because it belongs to the camera.
59
+ - **Applies when:** Every game with a HUD, and every game a trailer will be cut from.
60
+ - **Verify:** With the setting off, count rendered HUD elements in every state, including a death, a subtitle line and a toast: zero. Toggle it with its key mid-fight.
61
+
62
+ ### Colour is never the only signal
63
+ - **Invariant:** Every state shown with colour (team, rarity, selection, damage type, danger) is also shown by shape, icon, text or position, and a colour keeps one meaning across the whole game.
64
+ - **Technique:** Pair each colour with a second channel and check the palette under colour-vision simulations; keep text and important icons above contrast minimums against what is behind them. Write down what each gameplay colour means and check every glow, marker and bar against it.
65
+ - **Reference configuration:** SR's design rule: a state has a shape, so its yellow selection always comes with an underline, size, rank position or focus outline. Contrast floors from WCAG: 4.5:1 for body text, 3:1 for large text. OC: orange means immune and cyan or violet means shoot here; a baked glow once said "shoot here" while the health bar said immune. OC ships a colour-blind palette. LC tells its perk icons apart by shape.
66
+ - **Applies when:** Every game.
67
+ - **Verify:** Capture the HUD and menus through protanopia, deuteranopia and tritanopia simulations and in greyscale; every state is still distinguishable.
68
+
69
+ ### Flashes are limited at the source
70
+ - **Invariant:** No effect makes the screen's brightness change quickly enough or often enough, rising or falling, to count as a photosensitive flash.
71
+ - **Technique:** Bound the frame-to-frame change of composited luminance for full-screen effects in both directions, discovered by measuring every large overlay rather than reading a list, and bound how many large flashes can happen in a second. Offer a setting that reduces every flash further. Prefer fades to cuts for whole-screen changes, and ease any light that flickers at random.
72
+ - **Reference configuration:** AW limits each overlay's frame-to-frame luminance step to 0.045, under half of WCAG 2.3.1's 0.10 flash pair, after two players reported flashing violent enough to fear a seizure; its budgets allow zero steps over that limit. OC: at most 3 full-frame flashes a second and no 10-11 Hz strobe; Reduce Flashing scales every flash to 20% and removes the boss's 12 Hz wind-up blink; the storm light flickered at random near 11 Hz and needed easing. OC's new lightning cut the flat-white share of a first-person frame from 10.47% to 0.58%. LC offers Reduce Flashing and also reads `prefers-reduced-motion`.
73
+ - **Applies when:** Every game with flashes, explosions, damage effects or lightning.
74
+ - **Verify:** Record the worst flash in the game (an explosion at point blank, a lightning strike) and compute per-frame mean luminance; no step exceeds the limit and no second holds more large flashes than the limit. Repeat with Reduce Flashing on.
75
+
76
+ ### Reduced motion and a calm look are honoured
77
+ - **Invariant:** When the player asks for less motion, through the operating system or the game's own calm setting, decorative motion is removed rather than frozen, and every piece of information it carried is still shown.
78
+ - **Technique:** Read `prefers-reduced-motion` and a game setting, and offer the calm setting even when the system preference is off. Replace menu films with their stills, remove parallax, shake, bob and drifting backgrounds, swap animated transitions for fades, remove moving layers of menu effects rather than freezing them mid-frame, and still the world's flashes, while keeping a stable cue for every state change.
79
+ - **Reference configuration:** AW gates its menu films on reduced motion; ST shows the static poster with no autoplay and keeps a stable information cue in place of motion. In OC, reduced motion keeps the directional hit cues and drops the camera kick. OH's Calm look stills the stage's drift and its flashes while the board and its cues stay. LC's reduced motion removes its tape layers instead of freezing them.
80
+ - **Applies when:** Every game with decorative motion.
81
+ - **Verify:** Turn on reduced motion in the operating system, reload, and walk the menus and the first minute of play: no film plays, nothing shakes or drifts, and nothing that mattered disappeared. Repeat with only the game's calm setting on.
82
+
83
+ ### Menus work from the keyboard, read correctly, and pause has a second key
84
+ - **Invariant:** Every menu and dialog works with the keyboard alone, focus is always visible and lands somewhere sensible, controls have real names, and pause still works when the browser or a host page takes Escape.
85
+ - **Technique:** Real buttons and form controls, a visible focus style, Tab order that follows the layout, Escape for back, focus moved into a dialog on open and restored on close, and background controls made unreachable while a dialog is open. Give pause a second key beside Escape, because a browser leaving fullscreen or a host page in fullscreen spends Escape before the game sees it.
86
+ - **Reference configuration:** ST's front-end rules: Enter and Space activate the focused action, modal settings and pause contain focus, menus reflow at 200% zoom without clipped actions. OH pauses on P as well as Escape, because a host in fullscreen takes Escape. LC makes destructive actions holds, or a click that arms and a second that confirms.
87
+ - **Applies when:** Every game.
88
+ - **Verify:** Unplug the mouse and walk title, settings, pause, results and retry; then run an automated accessibility scan of each menu. In fullscreen, pause with the second key.
89
+
90
+ ### Difficulty and timing can be adjusted
91
+ - **Invariant:** A player who cannot react as fast or press as accurately as the default assumes can still progress.
92
+ - **Technique:** Offer options that change timing windows, game speed, aim assistance or damage taken, with labels that say what each one changes, without locking content behind the default.
93
+ - **Reference configuration:** Outside guidance recommends offering a range of difficulty and the ability to slow the game. LC offers aim help off, standard and strong. A rhythm game's timing windows and latency calibration are in `opengame-rhythm`.
94
+ - **Applies when:** Games with timing-heavy challenges.
95
+ - **Verify:** Complete the first objective at the most assisted setting with slow, imprecise input.
96
+
97
+ ### Every option is proven in play, on and off
98
+ - **Invariant:** Each accessibility and comfort option changes what it says it changes in a real run, both ways, and survives a reload.
99
+ - **Technique:** For each option, record the same moment of play with it on and off and compare: a lightning strike with Reduce Flashing, a voice line with subtitles, a hit with shake off, a remapped key in a match, a death with zero HUD. Save, reload and check the value, including off and zero. New movement or control features ship as saved toggles with a sensible default. Persistence rules are in `opengame-front-end`.
100
+ - **Reference configuration:** At OC's launch audit, volume, sensitivity, field of view, rebinding, the colour-blind palette, Reduce Flashing and subtitle size all existed and were all "unverified at runtime"; Reduce Flashing had never been checked by eye. OC's chained jumps ship on by default, and off persists. LC shipped Reduce Flashing, subtitles with size, invert Y, hold-to-confirm, an aiming dot off by default, a brightness card on the renderer's own curve, 2^((b - 0.5) x 1.6), aim help and shape-coded perk icons; its zero-HUD setting was proven by element count, and none of its pad options was tried by a person.
101
+ - **Applies when:** Every game with an accessibility or settings menu.
102
+ - **Verify:** A table with one row per option: an on clip, an off clip and a reload check, each linked.