@opengamehq/skills 1.4.0 → 1.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (382) hide show
  1. package/CHANGELOG.md +29 -0
  2. package/README.md +12 -4
  3. package/dist/.claude-plugin/marketplace.json +26 -0
  4. package/dist/skills/manifest.json +1406 -142
  5. package/dist/skills/opengame-accessibility/CHANGELOG.md +4 -0
  6. package/dist/skills/opengame-accessibility/SKILL.md +48 -32
  7. package/dist/skills/opengame-all-in-one/CHANGELOG.md +21 -0
  8. package/dist/skills/opengame-all-in-one/SKILL.md +195 -0
  9. package/dist/skills/opengame-all-in-one/references/opengame-accessibility/README.md +102 -0
  10. package/dist/skills/opengame-all-in-one/references/opengame-api/README.md +107 -0
  11. package/dist/skills/opengame-all-in-one/references/opengame-assets/README.md +168 -0
  12. package/dist/skills/opengame-all-in-one/references/opengame-assets/references/pipeline.md +164 -0
  13. package/dist/skills/opengame-all-in-one/references/opengame-audio/README.md +238 -0
  14. package/dist/skills/opengame-all-in-one/references/opengame-audio/helpers/audio-chain.js +325 -0
  15. package/dist/skills/opengame-all-in-one/references/opengame-audio/references/mix-notes.md +125 -0
  16. package/dist/skills/opengame-all-in-one/references/opengame-audio/references/qa-without-ears.md +177 -0
  17. package/dist/skills/opengame-all-in-one/references/opengame-capture/README.md +128 -0
  18. package/dist/skills/opengame-all-in-one/references/opengame-capture/references/pipeline.md +114 -0
  19. package/dist/skills/opengame-all-in-one/references/opengame-capture/references/threejs.md +161 -0
  20. package/dist/skills/opengame-all-in-one/references/opengame-characters/README.md +180 -0
  21. package/dist/skills/opengame-all-in-one/references/opengame-characters/references/first-person-body.md +108 -0
  22. package/dist/skills/opengame-all-in-one/references/opengame-characters/references/integration.md +144 -0
  23. package/dist/skills/opengame-all-in-one/references/opengame-characters/references/player-og.md +160 -0
  24. package/dist/skills/opengame-all-in-one/references/opengame-cli/README.md +189 -0
  25. package/dist/skills/opengame-all-in-one/references/opengame-deploy/README.md +223 -0
  26. package/dist/skills/opengame-all-in-one/references/opengame-deploy/references/json-events.md +63 -0
  27. package/dist/skills/opengame-all-in-one/references/opengame-deploy/references/manifest.md +89 -0
  28. package/dist/skills/opengame-all-in-one/references/opengame-deploy/references/packaging.md +119 -0
  29. package/dist/skills/opengame-all-in-one/references/opengame-depth/README.md +154 -0
  30. package/dist/skills/opengame-all-in-one/references/opengame-enemies/README.md +155 -0
  31. package/dist/skills/opengame-all-in-one/references/opengame-enemies/references/pacing-and-bots.md +108 -0
  32. package/dist/skills/opengame-all-in-one/references/opengame-enemies/references/threejs.md +193 -0
  33. package/dist/skills/opengame-all-in-one/references/opengame-front-end/README.md +185 -0
  34. package/dist/skills/opengame-all-in-one/references/opengame-front-end/references/launch.md +50 -0
  35. package/dist/skills/opengame-all-in-one/references/opengame-front-end/references/menus.md +81 -0
  36. package/dist/skills/opengame-all-in-one/references/opengame-game-feel/README.md +181 -0
  37. package/dist/skills/opengame-all-in-one/references/opengame-game-feel/helpers/spring.js +146 -0
  38. package/dist/skills/opengame-all-in-one/references/opengame-game-feel/references/feel-numbers.md +142 -0
  39. package/dist/skills/opengame-all-in-one/references/opengame-game-feel/references/killcam.md +88 -0
  40. package/dist/skills/opengame-all-in-one/references/opengame-jam/README.md +114 -0
  41. package/dist/skills/opengame-all-in-one/references/opengame-lighting/README.md +141 -0
  42. package/dist/skills/opengame-all-in-one/references/opengame-lighting/helpers/light-pool.js +185 -0
  43. package/dist/skills/opengame-all-in-one/references/opengame-loading/README.md +135 -0
  44. package/dist/skills/opengame-all-in-one/references/opengame-loading/helpers/loading-count.mjs +115 -0
  45. package/dist/skills/opengame-all-in-one/references/opengame-loading/references/threejs.md +141 -0
  46. package/dist/skills/opengame-all-in-one/references/opengame-look/README.md +181 -0
  47. package/dist/skills/opengame-all-in-one/references/opengame-look/references/matching-a-reference.md +73 -0
  48. package/dist/skills/opengame-all-in-one/references/opengame-look/references/painterly.md +69 -0
  49. package/dist/skills/opengame-all-in-one/references/opengame-look/references/post-and-lens.md +73 -0
  50. package/dist/skills/opengame-all-in-one/references/opengame-maps/README.md +74 -0
  51. package/dist/skills/opengame-all-in-one/references/opengame-maps/references/map-spec.md +77 -0
  52. package/dist/skills/opengame-all-in-one/references/opengame-mobile/README.md +86 -0
  53. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/README.md +183 -0
  54. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/briefs.md +293 -0
  55. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/day-one-questions.md +46 -0
  56. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/edge-cases.md +27 -0
  57. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/filmable.md +244 -0
  58. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/finishing.md +126 -0
  59. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/measure.md +282 -0
  60. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-capture.md +151 -0
  61. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-gates.md +84 -0
  62. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-genres.md +198 -0
  63. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-grammar.md +320 -0
  64. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-ops.md +127 -0
  65. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/og-snipers-record.md +110 -0
  66. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/owner-eye.md +214 -0
  67. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/reference-study.md +293 -0
  68. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/song.md +64 -0
  69. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/README.md +193 -0
  70. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/briefs.md +293 -0
  71. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/day-one-questions.md +46 -0
  72. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/filmable.md +244 -0
  73. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/measure.md +282 -0
  74. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-capture.md +151 -0
  75. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-gates.md +84 -0
  76. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-genres.md +198 -0
  77. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-grammar.md +320 -0
  78. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-ops.md +127 -0
  79. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/og-snipers-record.md +110 -0
  80. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/owner-eye.md +214 -0
  81. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/reference-study.md +293 -0
  82. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/song.md +64 -0
  83. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/README.md +174 -0
  84. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/briefs.md +293 -0
  85. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/day-one-questions.md +46 -0
  86. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/filmable.md +244 -0
  87. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/finishing.md +126 -0
  88. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/measure.md +282 -0
  89. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-capture.md +151 -0
  90. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-gates.md +84 -0
  91. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-genres.md +198 -0
  92. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-grammar.md +320 -0
  93. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-ops.md +127 -0
  94. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/og-snipers-record.md +110 -0
  95. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/owner-eye.md +214 -0
  96. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/reference-study.md +293 -0
  97. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/song.md +64 -0
  98. package/dist/skills/opengame-all-in-one/references/opengame-multiplayer/README.md +139 -0
  99. package/dist/skills/opengame-all-in-one/references/opengame-multiplayer/references/bot-lobbies.md +71 -0
  100. package/dist/skills/opengame-all-in-one/references/opengame-multiplayer/references/netcode.md +165 -0
  101. package/dist/skills/opengame-all-in-one/references/opengame-performance/README.md +177 -0
  102. package/dist/skills/opengame-all-in-one/references/opengame-performance/helpers/landing-pacer.mjs +86 -0
  103. package/dist/skills/opengame-all-in-one/references/opengame-performance/references/measuring.md +123 -0
  104. package/dist/skills/opengame-all-in-one/references/opengame-performance/references/webgpu.md +86 -0
  105. package/dist/skills/opengame-all-in-one/references/opengame-production/README.md +192 -0
  106. package/dist/skills/opengame-all-in-one/references/opengame-production/references/team.md +107 -0
  107. package/dist/skills/opengame-all-in-one/references/opengame-production/references/templates.md +153 -0
  108. package/dist/skills/opengame-all-in-one/references/opengame-quality-bar/README.md +170 -0
  109. package/dist/skills/opengame-all-in-one/references/opengame-quality-bar/references/cheap-tells.md +43 -0
  110. package/dist/skills/opengame-all-in-one/references/opengame-quality-bar/references/judges.md +95 -0
  111. package/dist/skills/opengame-all-in-one/references/opengame-quality-bar/references/review-prompt.md +32 -0
  112. package/dist/skills/opengame-all-in-one/references/opengame-rhythm/README.md +134 -0
  113. package/dist/skills/opengame-all-in-one/references/opengame-rhythm/references/charting.md +109 -0
  114. package/dist/skills/opengame-all-in-one/references/opengame-rhythm/references/timing.md +92 -0
  115. package/dist/skills/opengame-all-in-one/references/opengame-router/README.md +54 -0
  116. package/dist/skills/opengame-all-in-one/references/opengame-router/references/process.md +38 -0
  117. package/dist/skills/opengame-all-in-one/references/opengame-scene-audit/README.md +136 -0
  118. package/dist/skills/opengame-all-in-one/references/opengame-scene-audit/helpers/scene-audit.js +677 -0
  119. package/dist/skills/opengame-all-in-one/references/opengame-sdk/README.md +283 -0
  120. package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/engines.md +93 -0
  121. package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/frame.md +107 -0
  122. package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/identity.md +111 -0
  123. package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/leaderboards.md +115 -0
  124. package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/radio.md +71 -0
  125. package/dist/skills/opengame-all-in-one/references/opengame-stability/README.md +112 -0
  126. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/README.md +160 -0
  127. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/archetypes.md +113 -0
  128. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/briefs.md +273 -0
  129. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/core.md +129 -0
  130. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/craft.md +299 -0
  131. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/edge-cases.md +27 -0
  132. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/filmable.md +244 -0
  133. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/finishing.md +126 -0
  134. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/gates.md +184 -0
  135. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/measure.md +282 -0
  136. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/music.md +148 -0
  137. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/og-clash-record.md +133 -0
  138. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/ops.md +154 -0
  139. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/owner-eye.md +214 -0
  140. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/review.md +141 -0
  141. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/title.md +92 -0
  142. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/README.md +172 -0
  143. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/archetypes.md +113 -0
  144. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/briefs.md +273 -0
  145. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/core.md +129 -0
  146. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/craft.md +299 -0
  147. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/edge-cases.md +27 -0
  148. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/filmable.md +244 -0
  149. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/finishing.md +126 -0
  150. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/gates.md +184 -0
  151. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/measure.md +282 -0
  152. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/music.md +148 -0
  153. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/og-clash-record.md +133 -0
  154. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/ops.md +154 -0
  155. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/owner-eye.md +214 -0
  156. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/reference-set.md +92 -0
  157. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/review.md +141 -0
  158. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/title.md +92 -0
  159. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/README.md +141 -0
  160. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/archetypes.md +113 -0
  161. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/briefs.md +273 -0
  162. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/core.md +129 -0
  163. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/craft.md +299 -0
  164. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/edge-cases.md +27 -0
  165. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/filmable.md +244 -0
  166. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/finishing.md +126 -0
  167. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/gates.md +184 -0
  168. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/measure.md +282 -0
  169. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/music.md +148 -0
  170. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/og-clash-record.md +133 -0
  171. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/ops.md +154 -0
  172. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/owner-eye.md +214 -0
  173. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/review.md +141 -0
  174. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/title.md +92 -0
  175. package/dist/skills/opengame-all-in-one/references/opengame-verification/README.md +197 -0
  176. package/dist/skills/opengame-all-in-one/references/opengame-verification/helpers/browser-evidence.mjs +74 -0
  177. package/dist/skills/opengame-all-in-one/references/opengame-weapons/README.md +179 -0
  178. package/dist/skills/opengame-all-in-one/references/opengame-weapons/references/handling-numbers.md +114 -0
  179. package/dist/skills/opengame-all-in-one/references/opengame-weapons/references/reloads-and-hands.md +96 -0
  180. package/dist/skills/opengame-all-in-one/references/opengame-weapons/references/sights-and-scopes.md +98 -0
  181. package/dist/skills/opengame-all-in-one/references/opengame-weapons/references/threejs.md +240 -0
  182. package/dist/skills/opengame-all-in-one/references/opengame-world-physics/README.md +141 -0
  183. package/dist/skills/opengame-all-in-one/references/opengame-world-physics/references/measured-failures.md +79 -0
  184. package/dist/skills/opengame-api/CHANGELOG.md +8 -0
  185. package/dist/skills/opengame-api/SKILL.md +39 -13
  186. package/dist/skills/opengame-assets/CHANGELOG.md +11 -0
  187. package/dist/skills/opengame-assets/SKILL.md +79 -31
  188. package/dist/skills/opengame-assets/references/pipeline.md +67 -0
  189. package/dist/skills/opengame-audio/CHANGELOG.md +11 -0
  190. package/dist/skills/opengame-audio/SKILL.md +129 -41
  191. package/dist/skills/opengame-audio/references/mix-notes.md +44 -1
  192. package/dist/skills/opengame-audio/references/qa-without-ears.md +177 -0
  193. package/dist/skills/opengame-capture/CHANGELOG.md +10 -0
  194. package/dist/skills/opengame-capture/SKILL.md +44 -20
  195. package/dist/skills/opengame-capture/references/pipeline.md +33 -1
  196. package/dist/skills/opengame-capture/references/threejs.md +17 -1
  197. package/dist/skills/opengame-characters/CHANGELOG.md +15 -0
  198. package/dist/skills/opengame-characters/SKILL.md +94 -39
  199. package/dist/skills/opengame-characters/references/first-person-body.md +108 -0
  200. package/dist/skills/opengame-characters/references/player-og.md +1 -1
  201. package/dist/skills/opengame-cli/CHANGELOG.md +12 -0
  202. package/dist/skills/opengame-cli/SKILL.md +11 -10
  203. package/dist/skills/opengame-deploy/CHANGELOG.md +20 -0
  204. package/dist/skills/opengame-deploy/SKILL.md +41 -21
  205. package/dist/skills/opengame-deploy/references/json-events.md +6 -5
  206. package/dist/skills/opengame-deploy/references/packaging.md +28 -26
  207. package/dist/skills/opengame-depth/CHANGELOG.md +8 -0
  208. package/dist/skills/opengame-depth/SKILL.md +61 -33
  209. package/dist/skills/opengame-enemies/CHANGELOG.md +10 -0
  210. package/dist/skills/opengame-enemies/SKILL.md +96 -40
  211. package/dist/skills/opengame-enemies/references/pacing-and-bots.md +108 -0
  212. package/dist/skills/opengame-enemies/references/threejs.md +59 -0
  213. package/dist/skills/opengame-front-end/CHANGELOG.md +4 -0
  214. package/dist/skills/opengame-front-end/SKILL.md +85 -39
  215. package/dist/skills/opengame-front-end/references/menus.md +42 -8
  216. package/dist/skills/opengame-game-feel/CHANGELOG.md +11 -0
  217. package/dist/skills/opengame-game-feel/SKILL.md +95 -47
  218. package/dist/skills/opengame-game-feel/references/feel-numbers.md +59 -0
  219. package/dist/skills/opengame-game-feel/references/killcam.md +88 -0
  220. package/dist/skills/opengame-jam/CHANGELOG.md +8 -0
  221. package/dist/skills/opengame-jam/SKILL.md +46 -31
  222. package/dist/skills/opengame-lighting/CHANGELOG.md +9 -0
  223. package/dist/skills/opengame-lighting/SKILL.md +85 -34
  224. package/dist/skills/opengame-loading/CHANGELOG.md +4 -0
  225. package/dist/skills/opengame-loading/SKILL.md +78 -38
  226. package/dist/skills/opengame-loading/helpers/loading-count.mjs +115 -0
  227. package/dist/skills/opengame-loading/references/threejs.md +32 -7
  228. package/dist/skills/opengame-look/CHANGELOG.md +9 -0
  229. package/dist/skills/opengame-look/SKILL.md +122 -51
  230. package/dist/skills/opengame-look/references/matching-a-reference.md +73 -0
  231. package/dist/skills/opengame-look/references/painterly.md +69 -0
  232. package/dist/skills/opengame-look/references/post-and-lens.md +10 -3
  233. package/dist/skills/opengame-maps/CHANGELOG.md +9 -0
  234. package/dist/skills/opengame-maps/SKILL.md +78 -0
  235. package/dist/skills/opengame-maps/references/map-spec.md +77 -0
  236. package/dist/skills/opengame-mobile/CHANGELOG.md +4 -0
  237. package/dist/skills/opengame-mobile/SKILL.md +18 -18
  238. package/dist/skills/opengame-montage-make/CHANGELOG.md +5 -0
  239. package/dist/skills/opengame-montage-make/SKILL.md +187 -0
  240. package/dist/skills/opengame-montage-make/references/briefs.md +293 -0
  241. package/dist/skills/opengame-montage-make/references/day-one-questions.md +46 -0
  242. package/dist/skills/opengame-montage-make/references/edge-cases.md +27 -0
  243. package/dist/skills/opengame-montage-make/references/filmable.md +244 -0
  244. package/dist/skills/opengame-montage-make/references/finishing.md +126 -0
  245. package/dist/skills/opengame-montage-make/references/measure.md +282 -0
  246. package/dist/skills/opengame-montage-make/references/montage-capture.md +151 -0
  247. package/dist/skills/opengame-montage-make/references/montage-gates.md +84 -0
  248. package/dist/skills/opengame-montage-make/references/montage-genres.md +198 -0
  249. package/dist/skills/opengame-montage-make/references/montage-grammar.md +320 -0
  250. package/dist/skills/opengame-montage-make/references/montage-ops.md +127 -0
  251. package/dist/skills/opengame-montage-make/references/og-snipers-record.md +110 -0
  252. package/dist/skills/opengame-montage-make/references/owner-eye.md +214 -0
  253. package/dist/skills/opengame-montage-make/references/reference-study.md +293 -0
  254. package/dist/skills/opengame-montage-make/references/song.md +64 -0
  255. package/dist/skills/opengame-montage-plan/CHANGELOG.md +5 -0
  256. package/dist/skills/opengame-montage-plan/SKILL.md +197 -0
  257. package/dist/skills/opengame-montage-plan/references/briefs.md +293 -0
  258. package/dist/skills/opengame-montage-plan/references/day-one-questions.md +46 -0
  259. package/dist/skills/opengame-montage-plan/references/filmable.md +244 -0
  260. package/dist/skills/opengame-montage-plan/references/measure.md +282 -0
  261. package/dist/skills/opengame-montage-plan/references/montage-capture.md +151 -0
  262. package/dist/skills/opengame-montage-plan/references/montage-gates.md +84 -0
  263. package/dist/skills/opengame-montage-plan/references/montage-genres.md +198 -0
  264. package/dist/skills/opengame-montage-plan/references/montage-grammar.md +320 -0
  265. package/dist/skills/opengame-montage-plan/references/montage-ops.md +127 -0
  266. package/dist/skills/opengame-montage-plan/references/og-snipers-record.md +110 -0
  267. package/dist/skills/opengame-montage-plan/references/owner-eye.md +214 -0
  268. package/dist/skills/opengame-montage-plan/references/reference-study.md +293 -0
  269. package/dist/skills/opengame-montage-plan/references/song.md +64 -0
  270. package/dist/skills/opengame-montage-review-and-improve/CHANGELOG.md +5 -0
  271. package/dist/skills/opengame-montage-review-and-improve/SKILL.md +178 -0
  272. package/dist/skills/opengame-montage-review-and-improve/references/briefs.md +293 -0
  273. package/dist/skills/opengame-montage-review-and-improve/references/day-one-questions.md +46 -0
  274. package/dist/skills/opengame-montage-review-and-improve/references/filmable.md +244 -0
  275. package/dist/skills/opengame-montage-review-and-improve/references/finishing.md +126 -0
  276. package/dist/skills/opengame-montage-review-and-improve/references/measure.md +282 -0
  277. package/dist/skills/opengame-montage-review-and-improve/references/montage-capture.md +151 -0
  278. package/dist/skills/opengame-montage-review-and-improve/references/montage-gates.md +84 -0
  279. package/dist/skills/opengame-montage-review-and-improve/references/montage-genres.md +198 -0
  280. package/dist/skills/opengame-montage-review-and-improve/references/montage-grammar.md +320 -0
  281. package/dist/skills/opengame-montage-review-and-improve/references/montage-ops.md +127 -0
  282. package/dist/skills/opengame-montage-review-and-improve/references/og-snipers-record.md +110 -0
  283. package/dist/skills/opengame-montage-review-and-improve/references/owner-eye.md +214 -0
  284. package/dist/skills/opengame-montage-review-and-improve/references/reference-study.md +293 -0
  285. package/dist/skills/opengame-montage-review-and-improve/references/song.md +64 -0
  286. package/dist/skills/opengame-multiplayer/CHANGELOG.md +15 -0
  287. package/dist/skills/opengame-multiplayer/SKILL.md +143 -0
  288. package/dist/skills/opengame-multiplayer/references/bot-lobbies.md +71 -0
  289. package/dist/skills/opengame-multiplayer/references/netcode.md +165 -0
  290. package/dist/skills/opengame-performance/CHANGELOG.md +8 -0
  291. package/dist/skills/opengame-performance/SKILL.md +106 -65
  292. package/dist/skills/opengame-performance/helpers/landing-pacer.mjs +86 -0
  293. package/dist/skills/opengame-performance/references/measuring.md +51 -0
  294. package/dist/skills/opengame-performance/references/webgpu.md +86 -0
  295. package/dist/skills/opengame-production/CHANGELOG.md +13 -0
  296. package/dist/skills/opengame-production/SKILL.md +119 -54
  297. package/dist/skills/opengame-production/references/team.md +107 -0
  298. package/dist/skills/opengame-production/references/templates.md +106 -16
  299. package/dist/skills/opengame-quality-bar/CHANGELOG.md +10 -0
  300. package/dist/skills/opengame-quality-bar/SKILL.md +94 -42
  301. package/dist/skills/opengame-quality-bar/references/cheap-tells.md +14 -7
  302. package/dist/skills/opengame-quality-bar/references/judges.md +95 -0
  303. package/dist/skills/opengame-quality-bar/references/review-prompt.md +10 -5
  304. package/dist/skills/opengame-rhythm/CHANGELOG.md +5 -0
  305. package/dist/skills/opengame-rhythm/SKILL.md +138 -0
  306. package/dist/skills/opengame-rhythm/references/charting.md +109 -0
  307. package/dist/skills/opengame-rhythm/references/timing.md +92 -0
  308. package/dist/skills/opengame-router/CHANGELOG.md +8 -0
  309. package/dist/skills/opengame-router/SKILL.md +14 -7
  310. package/dist/skills/opengame-scene-audit/CHANGELOG.md +15 -0
  311. package/dist/skills/opengame-scene-audit/SKILL.md +64 -47
  312. package/dist/skills/opengame-scene-audit/helpers/scene-audit.js +97 -19
  313. package/dist/skills/opengame-sdk/CHANGELOG.md +12 -0
  314. package/dist/skills/opengame-sdk/SKILL.md +26 -9
  315. package/dist/skills/opengame-sdk/references/engines.md +2 -2
  316. package/dist/skills/opengame-sdk/references/identity.md +10 -11
  317. package/dist/skills/opengame-stability/CHANGELOG.md +4 -0
  318. package/dist/skills/opengame-stability/SKILL.md +59 -27
  319. package/dist/skills/opengame-trailer-make/CHANGELOG.md +5 -0
  320. package/dist/skills/opengame-trailer-make/SKILL.md +164 -0
  321. package/dist/skills/opengame-trailer-make/references/archetypes.md +113 -0
  322. package/dist/skills/opengame-trailer-make/references/briefs.md +273 -0
  323. package/dist/skills/opengame-trailer-make/references/core.md +129 -0
  324. package/dist/skills/opengame-trailer-make/references/craft.md +299 -0
  325. package/dist/skills/opengame-trailer-make/references/edge-cases.md +27 -0
  326. package/dist/skills/opengame-trailer-make/references/filmable.md +244 -0
  327. package/dist/skills/opengame-trailer-make/references/finishing.md +126 -0
  328. package/dist/skills/opengame-trailer-make/references/gates.md +184 -0
  329. package/dist/skills/opengame-trailer-make/references/measure.md +282 -0
  330. package/dist/skills/opengame-trailer-make/references/music.md +148 -0
  331. package/dist/skills/opengame-trailer-make/references/og-clash-record.md +133 -0
  332. package/dist/skills/opengame-trailer-make/references/ops.md +154 -0
  333. package/dist/skills/opengame-trailer-make/references/owner-eye.md +214 -0
  334. package/dist/skills/opengame-trailer-make/references/review.md +141 -0
  335. package/dist/skills/opengame-trailer-make/references/title.md +92 -0
  336. package/dist/skills/opengame-trailer-plan/CHANGELOG.md +5 -0
  337. package/dist/skills/opengame-trailer-plan/SKILL.md +176 -0
  338. package/dist/skills/opengame-trailer-plan/references/archetypes.md +113 -0
  339. package/dist/skills/opengame-trailer-plan/references/briefs.md +273 -0
  340. package/dist/skills/opengame-trailer-plan/references/core.md +129 -0
  341. package/dist/skills/opengame-trailer-plan/references/craft.md +299 -0
  342. package/dist/skills/opengame-trailer-plan/references/edge-cases.md +27 -0
  343. package/dist/skills/opengame-trailer-plan/references/filmable.md +244 -0
  344. package/dist/skills/opengame-trailer-plan/references/finishing.md +126 -0
  345. package/dist/skills/opengame-trailer-plan/references/gates.md +184 -0
  346. package/dist/skills/opengame-trailer-plan/references/measure.md +282 -0
  347. package/dist/skills/opengame-trailer-plan/references/music.md +148 -0
  348. package/dist/skills/opengame-trailer-plan/references/og-clash-record.md +133 -0
  349. package/dist/skills/opengame-trailer-plan/references/ops.md +154 -0
  350. package/dist/skills/opengame-trailer-plan/references/owner-eye.md +214 -0
  351. package/dist/skills/opengame-trailer-plan/references/reference-set.md +92 -0
  352. package/dist/skills/opengame-trailer-plan/references/review.md +141 -0
  353. package/dist/skills/opengame-trailer-plan/references/title.md +92 -0
  354. package/dist/skills/opengame-trailer-review-and-improve/CHANGELOG.md +5 -0
  355. package/dist/skills/opengame-trailer-review-and-improve/SKILL.md +145 -0
  356. package/dist/skills/opengame-trailer-review-and-improve/references/archetypes.md +113 -0
  357. package/dist/skills/opengame-trailer-review-and-improve/references/briefs.md +273 -0
  358. package/dist/skills/opengame-trailer-review-and-improve/references/core.md +129 -0
  359. package/dist/skills/opengame-trailer-review-and-improve/references/craft.md +299 -0
  360. package/dist/skills/opengame-trailer-review-and-improve/references/edge-cases.md +27 -0
  361. package/dist/skills/opengame-trailer-review-and-improve/references/filmable.md +244 -0
  362. package/dist/skills/opengame-trailer-review-and-improve/references/finishing.md +126 -0
  363. package/dist/skills/opengame-trailer-review-and-improve/references/gates.md +184 -0
  364. package/dist/skills/opengame-trailer-review-and-improve/references/measure.md +282 -0
  365. package/dist/skills/opengame-trailer-review-and-improve/references/music.md +148 -0
  366. package/dist/skills/opengame-trailer-review-and-improve/references/og-clash-record.md +133 -0
  367. package/dist/skills/opengame-trailer-review-and-improve/references/ops.md +154 -0
  368. package/dist/skills/opengame-trailer-review-and-improve/references/owner-eye.md +214 -0
  369. package/dist/skills/opengame-trailer-review-and-improve/references/review.md +141 -0
  370. package/dist/skills/opengame-trailer-review-and-improve/references/title.md +92 -0
  371. package/dist/skills/opengame-verification/CHANGELOG.md +11 -0
  372. package/dist/skills/opengame-verification/SKILL.md +113 -48
  373. package/dist/skills/opengame-weapons/CHANGELOG.md +11 -0
  374. package/dist/skills/opengame-weapons/SKILL.md +129 -55
  375. package/dist/skills/opengame-weapons/references/handling-numbers.md +42 -0
  376. package/dist/skills/opengame-weapons/references/reloads-and-hands.md +96 -0
  377. package/dist/skills/opengame-weapons/references/sights-and-scopes.md +98 -0
  378. package/dist/skills/opengame-weapons/references/threejs.md +71 -0
  379. package/dist/skills/opengame-world-physics/CHANGELOG.md +9 -0
  380. package/dist/skills/opengame-world-physics/SKILL.md +55 -24
  381. package/dist/skills/opengame-world-physics/references/measured-failures.md +28 -1
  382. package/package.json +1 -1
@@ -18,12 +18,22 @@ const ktx2 = new KTX2Loader()
18
18
  .detectSupport(renderer); // for WebGPURenderer, after `await renderer.init()`
19
19
  ```
20
20
 
21
- - ETC1S is small and soft; UASTC is larger and sharp. AW measured ETC1S good enough for
22
- its normals at a sixth of UASTC's bytes (see `opengame-performance`). Measure per class.
21
+ - ETC1S is small and soft; UASTC is larger and sharp. Choose by the map's role, then
22
+ measure: LC ships colour seen at a distance as ETC1S and normal and data maps as
23
+ UASTC (world textures on the card went from 800.7 MB to 172 MB), while AW measured
24
+ ETC1S good enough for its normals at a sixth of UASTC's bytes (see
25
+ `opengame-performance`).
26
+ - Store mips smallest first. The file's prefix is then a smaller valid texture: fetch it
27
+ first, draw it, and sharpen in place when the rest arrives. LC's 88 first-set files are
28
+ 22.6 MB whole and 8.0 MB without their top level, and a test proved the dropped-mip
29
+ prefix transcodes to exactly the same bytes through the real transcoder.
30
+ - In LC's WebGPU build, compressed array textures flagged `isArrayTexture` drew black.
31
+ Look at one on screen before converting a whole set.
23
32
  - Phones need lower top mips as well as a different transcode target. Ship a mip-trimmed
24
33
  file per device class and pick it from the manifest, so a phone does not download mips
25
34
  it will throw away (see `opengame-mobile`).
26
- - Encode with `gltf-transform` (`--texture-compress ktx2`) or KTX-Software's `toktx`.
35
+ - Encode with `gltf-transform` (`--texture-compress ktx2`) or KTX-Software's `toktx`. An
36
+ in-browser WASM encoder works with no binary install, at about 100 s per 2048 map (LC).
27
37
 
28
38
  ## Geometry: meshopt or Draco
29
39
 
@@ -59,7 +69,11 @@ to 100%. Use one manager per tier (boot, first use, rest) so each tier has its o
59
69
  `total` is 0 when the header is missing. Recent `FileLoader` versions read an
60
70
  `X-File-Size` header first when the server sends one. Manifest sizes avoid all of it.
61
71
  - Add fixed weights for work that is not a download: `renderer.compileAsync(scene,
62
- camera)` for shaders, PMREM environment maps, building instanced scenes.
72
+ camera)` for shaders, PMREM environment maps, building instanced scenes. On a return
73
+ visit, weight each stage by its seconds last time (`helpers/loading-count.mjs`).
74
+ - With `WebGPURenderer`, `compileAsync` covers only the pass that draws to the canvas.
75
+ Passes into render targets (shadows, post, a scope) need their own warm draw, or they
76
+ compile in play (see `opengame-performance`).
63
77
  - `manager.setURLModifier` maps logical names to hashed URLs from the manifest.
64
78
  - `manager.onError` fires per failed URL. Retry from there (or from your own fetch
65
79
  wrapper) instead of letting the tier wait forever.
@@ -108,9 +122,20 @@ tab memory with the cache on and off.
108
122
 
109
123
  ## Upload and memory
110
124
 
111
- - `ImageBitmapLoader` decodes images off the main thread. After the GPU upload, close
112
- the bitmap so its CPU copy is freed (see `opengame-mobile` for when that is safe).
125
+ - `ImageBitmapLoader` decodes images off the main thread, as does `fetch` plus
126
+ `createImageBitmap(blob)` handed to a `Texture`. `TextureLoader` goes through an
127
+ `<img>` element; LC measured that path at 2.5 s of decode on the main thread. After the
128
+ GPU upload, close the bitmap so its CPU copy is freed (see `opengame-mobile` for when
129
+ that is safe).
130
+ - three.js builds a geometry's GPU buffers on the frame that first draws it. A warm-up that
131
+ draws every hidden mesh at once builds them all in one frame (LC: 346 hidden meshes,
132
+ 72-134 MB of buffers in one second before the menu). Warm in slices, nearest first.
133
+ - To show the menu only when the GPU has caught up, await
134
+ `renderer.backend.device.queue.onSubmittedWorkDone()` after the warm frames (check the
135
+ property path against your three.js version), with a timeout so a busy GPU cannot hold
136
+ the menu for ever.
113
137
  - Call `dispose()` on geometries, materials and textures you unload, and watch
114
138
  `renderer.info.memory` fall.
115
- - `renderer.compileAsync` before the menu lifts keeps shader links out of play (see
139
+ - `renderer.compileAsync` before the menu lifts keeps the canvas pass's shader links out
140
+ of play; draw once through every render-target pass as well (see
116
141
  `opengame-performance`).
@@ -1,5 +1,14 @@
1
1
  # opengame-look changelog
2
2
 
3
+ ## 1.1.0
4
+
5
+ Adds what OG Snipers, Last Contact and OG Hero taught: turning a reference into written
6
+ statements and measured layers, global look causes checked before any one map, the horizon
7
+ and haze in every weather, graded and coated materials, dark surfaces made dark by sheen
8
+ rather than albedo, materials before props, thin detail and foliage that do not crawl,
9
+ near fire, and painterly rendering. "Materials are honest" now allows a written in-between
10
+ metalness for coats, which Last Contact needed.
11
+
3
12
  ## 1.0.0
4
13
 
5
14
  First public release, in the opengamehq/opengame repository and the OpenGame CLI.
@@ -1,40 +1,55 @@
1
1
  ---
2
2
  name: opengame-look
3
- description: Make a three.js browser game's image hold up. Covers linear HDR rendering with one tone curve, a sky inside the exposure, fog that leaves the sky alone, the concept's lens, bloom that keeps small glows small, an authored grade, honest materials, detail that does not tile or shimmer, and a look bible. Use when the person says it looks flat, washed out, plastic, like a prototype, too dark, too bright, the sky looks pale, the colours are off, or wants a cinematic or AAA look.
3
+ description: Make a three.js browser game's image hold up. Covers a reference turned into statements and numbers, global causes before per-map tuning, one tone curve, sky, fog and horizon in every weather, the lens, small glows, the grade, graded materials, materials before props, detail and foliage that do not crawl, near fire and painterly rendering. Use when the person says it looks flat, washed out, plastic, like a prototype, too dark, things shimmer, or wants a cinematic, painterly or AAA look.
4
4
  metadata:
5
- version: "1.0.0"
5
+ version: "1.1.0"
6
6
  ---
7
7
 
8
8
  # The look
9
9
 
10
- The image is decided by a handful of choices made once: where the tone curve lives, what
11
- the grade is, which surfaces may bloom, and what materials are allowed to be. Make them
12
- on purpose and write them down; most "it looks like a prototype" reports are one of
13
- these left at a default.
10
+ The image is decided by a handful of choices made once: what the reference measures as,
11
+ where the tone curve lives, what the grade is, which surfaces may bloom, and what
12
+ materials are allowed to be. Make them on purpose and write them down; most "it looks
13
+ like a prototype" reports are one of these left at a default, and most "it looks worse
14
+ after the fix" reports are a fix judged on a still when the fault lives in motion.
14
15
 
15
16
  Rules carry five tags; `opengame-quality-bar` explains them and the game codes (DK, MC,
16
- AW, SR, ST, OC).
17
+ AW, SR, ST, OC, OS, LC, OH).
17
18
 
18
19
  ## Rules
19
20
 
21
+ ### Turn the reference into written statements first
22
+ - **Invariant:** Before the scene is built, the look exists as short sentences a stranger can mark pass or fail on a capture (lens, exposure behaviour, light sources, palette, ground, hands, HUD) plus one table of values per level, and every later change to the look edits that page, not scattered constants.
23
+ - **Technique:** Pull a frame from the reference every few seconds into contact sheets, add a handful of hand-picked stills, and write what they show as sentences anyone can check ("with nothing lit the night is black, not dusk-blue"), never "make it look like the video". Keep the palette, tone curve, grade, light rig, material rules and what may bloom in one table per level that the build reads. Keep an inventory of every kind of visible thing marked placeholder, passable or final, and promote a row only with a capture beside the reference. [references/matching-a-reference.md](references/matching-a-reference.md) has the whole method.
24
+ - **Reference configuration:** LC cut its reference film at one frame every 5 s into 4 by 3 sheets of 640 by 360 tiles plus 6 to 8 stills, and wrote statements such as "a flash shows every face for one frame, the sensor recovers in ~0.5 s" and "rain only visible in the cone and the flash". The lens and exposure matched the film; the inventory still read 0 of 73 guns photoreal at the end, which is what an honest inventory is for. DK and MC keep the grade as one table per map; ST writes a look target from the selected concept views before production.
25
+ - **Applies when:** Every game with a rendered world, and every time the owner supplies a film, trailer, concept art or mood board.
26
+ - **Verify:** A reviewer who never read the code marks each statement on a fresh capture, and the values read from the renderer and post passes at runtime match the table.
27
+
28
+ ### Measure the reference's layers before tuning any of them
29
+ - **Invariant:** Every layer of the target look (strokes, line, halftone, grain, lens, grade, light levels, colour ratios, motion timings) has a name, a technique and a number measured from the reference, and an adjective in a note is never read as a setting to turn up.
30
+ - **Technique:** Open the reference itself and measure it: box luminance at fixed places in stills of the same state as the frame you judge, channel ratios of key surfaces, stroke and dot sizes in pixels, the field of view, the share of the frame a held object takes. Write the numbers into the look page, build to them, and put reference and game side by side at the same size. When a note asks for "stronger" or "scarier", match the reference first, go past it only on the owner's word after they have seen the matched version, and write down where their word overrides the reference. Study a reference's method; never copy its code or art.
31
+ - **Reference configuration:** LC's tape effect: "a bit trippy and distorted" was read as a setting to turn up and rejected as "way too aggressive"; the matched version had grain 0.05 at 4 steps per 0.5 s, scan lines 1 px in 3 at alpha 0.035 and one 14vh band drifting up over 11 s. LC's darkness came from box readings of film stills (forest 0.009 to 0.020 of white, sky 57 to 80 of 255, lamp pool tops 111 to 124) before the owner's "make it scarier" overrode it. LC once ruled a resting pistol from the film's aiming frames, and the owner answered with a rest frame. OH: 5 to 15 strokes a face at 40 to 120 px on a 1600-wide frame, halftone of about 6 px only in shadow, 30 to 40% bare paper, a 104 degree lens. OS matched dirt by channel ratio: G/R and B/R 0.63/0.36 became 0.77/0.57 against the reference's 0.80/0.54.
32
+ - **Applies when:** Matching concept art, a reference film or a named game, and any effect asked for by adjective.
33
+ - **Verify:** A table with one row per layer, reference against game, each row measured on captures of the same state, and the side-by-side picture at the same size.
34
+
35
+ ### Check the global causes before tuning any one map
36
+ - **Invariant:** Before anyone tunes one map's look, the whole game passes the global checks: every sun clears the terrain framing its play space, no surface is an accidental mirror, albedo sits in physical ranges, no texture overwrites another in the build, every level of detail uses the game's own shader, no opaque material is flagged cut-out, and no map inherits another screen's grade or light.
37
+ - **Technique:** Script each check and rerun it after every engine, importer or exporter upgrade: sun elevation against the ridge along its bearing; metalness and roughness as cooked; effective albedo (texture times tint) at player height; texture names shared across levels of detail; materials left on the default shader; alpha flags computed the way the cook computes them; each map's grade and light values read from the renderer's uniforms after a trip through the menus. Zoom in before relighting: a flat black surface is a binding fault until proven otherwise.
38
+ - **Reference configuration:** OS's "literally garbage graphics" (owner) sat on five global causes: suns 2 to 10 degrees below their own ridges (the owner's "no shadows"), 462 materials drawn as mirrors because an engine upgrade read smoothness as roughness, albedo of 0.01 to 0.06 (yard dirt 0.063 where real earth is 0.15 to 0.3), 167 of 730 textures overwritten by level-of-detail name clashes, and a 1.6 times pixel-ratio stretch. Any texel with alpha under 128 made a material cut-out, so 126 materials holed their shadows and lost contact occlusion. Every map ran the parent arena's storm grade (contrast 1.30, saturation 0.74), and 7 of 17 maps had no light preset of their own. 45 fill lights went onto rocks whose far levels of detail used the default shader.
39
+ - **Applies when:** Any lit 3D game with several maps or screens, after an engine or importer upgrade, or when every map reads flat or dark.
40
+ - **Verify:** Each script reports zero, and a shadow-only view of a backlit surface shows solid shadow.
41
+
20
42
  ### Render linear, tone map once
21
43
  - **Invariant:** The world renders in linear light with values above display white, and exactly one tone curve maps it to the screen.
22
44
  - **Technique:** Render into a half-float target with the renderer's own tone mapping off, then apply exposure, the tone curve and the grade in one composite pass. Or keep three's tone mapping and add no post. Never both. Then trace the frame from the tone curve to the screen and remove any later pass with a shoulder of its own (a grade, vignette or "filmic" pass), because a second highlight roll-off strips colour from every bright area. In three.js, `renderer.toneMapping` applies when drawing to the canvas or in `OutputPass`; a custom pass after either may not compress highlights.
23
- - **Reference configuration:** DK, MC and AW render into half-float targets with `NoToneMapping` and run AgX, exposure and the grade in one composite (AgX rolls highlights toward white instead of clipping to a hue). SR uses ACES at exposure 1.1 with no post. The ST starter uses ACES at about 0.8 for punch. OC applied a second strong highlight roll-off after ACES that also removed blue, and the concept's colour did not come back until it was taken out.
45
+ - **Reference configuration:** DK, MC and AW render into half-float targets with `NoToneMapping` and run AgX, exposure and the grade in one composite (AgX rolls highlights toward white instead of clipping to a hue). LC does the same on WebGPU, AgX once in its last lens pass. SR uses ACES at exposure 1.1 with no post. The ST starter uses ACES at about 0.8 for punch. OC applied a second strong highlight roll-off after ACES that also removed blue, and the concept's colour did not come back until it was taken out.
24
46
  - **Applies when:** Any lit 3D look. Pixel art, 2D and unlit retro looks use no tone mapping at all, so their colours stay exact.
25
- - **Verify:** Search the code for every place a tone curve is applied; there is one. Render a strip of grey and saturated patches from black to well above white through the full chain: each patch keeps its hue until it reaches white, and the strip shows one shoulder. A bright emissive rolls off smoothly in a capture instead of turning a flat hue.
26
-
27
- ### Write the look bible first
28
- - **Invariant:** Before building the scene there is one short written spec of the look: palette, tone curve, grade per level, light rig, material rules and what may bloom.
29
- - **Technique:** A page in the repository the build reads from, with one table of values per level or map. Every later change to the look edits the table, not scattered constants.
30
- - **Reference configuration:** DK and MC keep the grade as one table per map; ST writes a look target from the selected concept views before production.
31
- - **Applies when:** Every game with a rendered world.
32
- - **Verify:** The values in the running game (read them from the renderer and post passes at runtime) match the spec.
47
+ - **Verify:** Search the code for every place a tone curve is applied; there is one. Render a strip of grey and saturated patches from black to well above white through the full chain: each patch keeps its hue until it reaches white, and the strip shows one shoulder.
33
48
 
34
49
  ### The sky is inside the exposure range
35
50
  - **Invariant:** The sky's brightness falls inside the range the tone curve can show, so any change to the sky shows on screen.
36
51
  - **Technique:** Read the sky's linear value before the tone curve at the horizon and overhead, and set its intensity against the key light and the exposure, not by eye on the final frame. Keep a false-colour exposure view in the debug build. Before anyone tunes sky variants, swap two very different ones and confirm the capture changes. In three.js scale a sky texture with `scene.backgroundIntensity` or the sky shader's output, and read a half-float target before `OutputPass`.
37
- - **Reference configuration:** OC's sky was 5 to 10 times too bright for the exposure. It clipped into the top of the display curve, so every sky variant came out the same pale grey, and agents tuned variants that could not change through rounds r04 to r06. Measured on fixed crops later, OC's sky band read 56 to 67 against a target of 72 to 78.
52
+ - **Reference configuration:** OC's sky was 5 to 10 times too bright for the exposure. It clipped into the top of the display curve, so every sky variant came out the same pale grey, and agents tuned variants that could not change through rounds r04 to r06. OS holds the sky at 1.25 to 1.6 times a sunlit white wall; a 4 times horizon clipped (`opengame-lighting`).
38
53
  - **Applies when:** Any game with a visible sky, skybox or painted backdrop.
39
54
  - **Verify:** Capture one view with two different sky variants: the sky pixels differ. The false-colour view shows no clipped sky away from the sun or moon.
40
55
 
@@ -45,70 +60,126 @@ AW, SR, ST, OC).
45
60
  - **Applies when:** Fogged scenes with a sky dome, skybox or backdrop geometry.
46
61
  - **Verify:** Toggle fog in a debug build while looking at the horizon: the geometry changes and the sky does not.
47
62
 
63
+ ### Fog is the horizon
64
+ - **Invariant:** Fog takes the sky's horizon colour, so distant geometry dissolves into the sky rather than into a grey or white haze.
65
+ - **Technique:** Derive the fog colour from the sky shader's horizon term in code, not as a second constant, and cap its density per weather so it never washes a play space white.
66
+ - **Reference configuration:** DK locks fog and horizon to one value. Fog density 0.003 to 0.03 by mood across our earlier games; a white horizon is one of the cheap tells. OS caps haze at 0.0012 per m starting at 60 m and sky haze at 0.3.
67
+ - **Applies when:** Any outdoor or large interior scene with fog.
68
+ - **Verify:** Capture a long sightline. The farthest geometry's colour converges on the sky behind it.
69
+
70
+ ### The horizon is whole and steady, in every weather
71
+ - **Invariant:** The far plane reaches everything drawn, distance haze never shimmers, and every map in every weather keeps interiors dry, lanes readable and frames neither washed out nor crushed, from every camera the game uses.
72
+ - **Technique:** Set each map's far plane from its drawn reach, backdrops included. Apply haze inside materials from world position, never as a post pass that reads jittered depth after the temporal resolve. Decide rain per place, never per player: cast a cover grid at load so a roofed room never shows rain or a wet floor, and keep streaks straight under every camera, cinematic ones included. Run the defect and exposure sweeps in every weather preset, because clear-weather captures hide these.
73
+ - **Reference configuration:** OS: a 400 m far plane cut backdrops reaching 2.5 to 5 km, the owner's "beige outline of map below the cloudes", after three rounds chased occlusion, sun and upscaling. Haze moved into materials took a horizon from 1,693 spike pixels to 0. Haze caps cut a desert's washed-out frames from 50 to 91% to 2.5%. "if its raining and i go under a roof the whole map stops raining? ... thats not realistic" (owner). A six-preset sweep found 303 more defects, including rain in roofed rooms on six maps. Rain fanned out under a high spawn-cinematic lens while play looked fine. The matchmaking screen's "very wird looking exposure" came back three times in 20 hours, from haze painted over the page's still image and a rain grid masking haze, and the judges never saw it because their captures forced clear weather.
74
+ - **Applies when:** Large maps with backdrops, temporal anti-aliasing with haze, and any game with weather or lighting variants.
75
+ - **Verify:** Locked horizon captures with haze on and off, and every map's pre-match screen and first seconds of play in every weather with luma numbers (`opengame-lighting`).
76
+
48
77
  ### The lens matches the concept
49
78
  - **Invariant:** The player camera's field of view matches the concept art and the genre's reference, recorded as a vertical angle, and every capture tool reads the value the game uses.
50
- - **Technique:** Solve the camera from the concept (horizon height, subject size, camera height) and write its vertical field of view into the look bible. Convert a horizontal slider value with vertical = 2 atan(tan(horizontal / 2) / aspect). Capture scripts read the live camera, not a saved settings copy. In three.js `PerspectiveCamera.fov` is vertical, in degrees; call `updateProjectionMatrix()` after setting it. A first-person view model keeps its own lens (`opengame-weapons`).
51
- - **Reference configuration:** OC's concepts show a first-person lens of 50 to 55 degrees vertical, and the build ran at 66. Later a capture read a stale settings copy and stayed at 66.5 degrees. OC's view model used its own 75 degree lens.
79
+ - **Technique:** Solve the camera from the concept (horizon height, subject size, camera height) and write its vertical field of view into the look page. Convert a horizontal slider value with vertical = 2 atan(tan(horizontal / 2) / aspect). Capture scripts read the live camera, not a saved settings copy. In three.js `PerspectiveCamera.fov` is vertical, in degrees; call `updateProjectionMatrix()` after setting it. A first-person view model keeps its own lens (`opengame-weapons`). A lens that distorts (barrel, a painted world's bend) is applied in one place, and the HUD anchors to the distorted position.
80
+ - **Reference configuration:** OC's concepts show a first-person lens of 50 to 55 degrees vertical, and the build ran at 66; later a capture read a stale settings copy and stayed at 66.5. OC's view model used its own 75 degree lens. LC's body camera: a 100 degree setting with barrel 0.36 and overscan 1.28 gives about 81 degrees vertical, and its plain camera projection put HUD marks 0.5 m off at 5 m until they read the post-lens position. OH bends a 104 degree lens in the vertex shader.
52
81
  - **Applies when:** First- and third-person 3D games, and any game captured against concept art.
53
- - **Verify:** Write the camera's vertical field of view into each capture's metadata and compare it with the look bible. Overlay a capture on its concept: the horizon and the subject's size line up.
82
+ - **Verify:** Write the camera's vertical field of view into each capture's metadata and compare it with the look page. Overlay a capture on its concept: the horizon and the subject's size line up.
54
83
 
55
84
  ### Small glows stay small
56
85
  - **Invariant:** Thin or tiny emissive geometry (reticles, filaments, eyes, runes, cores) glows at its own size with no bloom rings, flowers or white suns.
57
86
  - **Technique:** Cap emissive intensity per material class and clamp before bloom. Draw reticles and holographic sights in a shader or sprite that bloom does not see, and give tiny glows a minimum size on screen instead of more intensity. In three.js put them on a layer excluded from `UnrealBloomPass` (three's selective bloom example does this with `Layers`), or draw them after the bloom pass.
58
- - **Reference configuration:** An OC holographic reticle was a 0.8 mm glowing torus, and bloom turned it into a 7-ring flower. Clipped emissive halos read as "four giant white suns". OC capped emissives near HDR 3 to 4, kept eye glows at 1.5 to 2 px or more, and cut its flat-white pixel share from 10.47% to 0.58%.
87
+ - **Reference configuration:** An OC holographic reticle was a 0.8 mm glowing torus, and bloom turned it into a 7-ring flower. Clipped emissive halos read as "four giant white suns". OC capped emissives near HDR 3 to 4, kept eye glows at 1.5 to 2 px or more, and cut its flat-white pixel share from 10.47% to 0.58%. LC draws far guide lights as 2.5 px hard points: "a hard point's size does not bring a far light back; its level does".
59
88
  - **Applies when:** Lit looks with bloom and any small emissive detail.
60
89
  - **Verify:** Capture each optic, eye and glowing detail at the nearest and farthest play distance, and count pixels above 0.95: the bright area is close to the detail's footprint.
61
90
 
62
91
  ### Find the broken channel before tuning colour
63
- - **Invariant:** A surface that looks wrong is traced to its channel (normals, albedo, material flags, light or post) before anyone changes a colour or a light.
64
- - **Technique:** Render the asset with normals only, then unlit albedo only, then lit with post off, and see which view shows the fault. In three.js swap in `MeshNormalMaterial`, then a `MeshBasicMaterial` with the albedo map.
65
- - **Reference configuration:** OC tuned albedo, fill and fire tint on a "black horde" for 10 rounds before finding that 7.7 to 25.8% of zombie vertices had normals opposed to their faces. Titan faceting blamed on decimation came from shader derivative curvature. The importer's metalness default of 1.0 turned surfaces into mirror slabs.
66
- - **Applies when:** Any asset that reads too dark, faceted, plastic or like foil.
67
- - **Verify:** The channel view that showed the fault changes after the fix, and the lit capture follows.
92
+ - **Invariant:** A surface that looks wrong is traced to its channel (normals, albedo, material flags, light or post) and to the object that draws it before anyone changes a colour or a light.
93
+ - **Technique:** Render the asset with normals only, then unlit albedo only, then lit with post off, and see which view shows the fault. In three.js swap in `MeshNormalMaterial`, then a `MeshBasicMaterial` with the albedo map. When the owner of a fault is unsure, hide one thing at a time on a frozen frame (groups, then meshes, then material terms and lights) by moving it to a hidden layer rather than setting `visible`, which other code writes back; prove the hide on one frame first, and ask "drawn and unlit?" before "missing?".
94
+ - **Reference configuration:** OC tuned albedo, fill and fire tint on a "black horde" for 10 rounds before finding that 7.7 to 25.8% of zombie vertices had normals opposed to their faces; the importer's metalness default of 1.0 turned surfaces into mirror slabs. LC's shoulder "hole", mended three times as a hole, was drawn and unlit cloth; hiding found a fault's owner in 2 short jobs where guessing had taken 4 jobs and 9 trials.
95
+ - **Applies when:** Any asset that reads too dark, faceted, plastic or like foil, and any visual fault whose cause is not certain.
96
+ - **Verify:** The channel view or the hide that showed the fault changes after the fix, and the lit capture follows. The report carries the frames with and without the hidden thing.
68
97
 
69
98
  ### An authored grade per level
70
99
  - **Invariant:** Each level has a grade chosen for it: exposure, contrast, saturation, lift and gain, with shadows and highlights pulled apart in temperature.
71
- - **Technique:** Lift-gamma-gain in the composite, contrast on luma, values from the look bible's table. Warm highlights over cool shadows is the common thread; break it on purpose.
72
- - **Reference configuration:** DK: exposure 2.45, saturation 1.10, contrast 1.075, lift (0.030, 0.040, 0.062), gain (1.045, 1.0, 0.955). MC Rust: contrast 1.18, lift (0.010, 0.018, 0.034), gain (1.10, 1.00, 0.84) as a highlight-only tilt, contrast on luma with a 0.055 toe.
73
- - **Applies when:** Any game with more than flat colour. An ungraded style says so in its bible.
100
+ - **Technique:** Lift-gamma-gain in the composite, contrast on luma, values from the look page's table, starting each level from neutral rather than from another level's or a parent game's grade. Warm highlights over cool shadows is the common thread; break it on purpose.
101
+ - **Reference configuration:** DK: exposure 2.45, saturation 1.10, contrast 1.075, lift (0.030, 0.040, 0.062), gain (1.045, 1.0, 0.955). MC Rust: contrast 1.18, lift (0.010, 0.018, 0.034), gain (1.10, 1.00, 0.84) as a highlight-only tilt, contrast on luma with a 0.055 toe. OS's inherited storm grade, with negative lift, crushed every shadow until each map got its own. LC gives the dark the reference's snow hue, because "a small sensor has no colour in the dark".
102
+ - **Applies when:** Any game with more than flat colour. An ungraded style says so in its look page.
74
103
  - **Verify:** Capture the same view with the grade off and on. Keep whichever reads play more clearly, and check threats, UI and team colours stay distinct.
75
104
 
76
105
  ### Bloom only where light is
77
106
  - **Invariant:** Only emissive sources, specular glints and effects bloom. A lit wall never glows.
78
107
  - **Technique:** Threshold bloom above display white in linear, with a soft knee and a clamp for fireflies, and author emissive and effect colours above one so they cross it.
79
- - **Reference configuration:** Threshold about 1.0 to 1.15 linear (AW sets 95% of display white), soft knee 0.7, firefly clamp 24, strength 0.3 to 0.6. Authored emissive: sparks (3.2, 2.1, 0.9), muzzle core (5.0, 3.6, 1.9), fireball (6.0, 3.0, 0.9) (DK, MC).
80
- - **Applies when:** Lit 3D looks with post. Stylised looks may skip bloom entirely.
108
+ - **Reference configuration:** Threshold about 1.0 to 1.15 linear (AW sets 95% of display white), soft knee 0.7, firefly clamp 24, strength 0.3 to 0.6. Authored emissive: sparks (3.2, 2.1, 0.9), muzzle core (5.0, 3.6, 1.9), fireball (6.0, 3.0, 0.9) (DK, MC). LC's body camera is the deliberate exception: five summed mip levels with no threshold ("a lens has none"), glow capped at 3 whites, streaks only over white, all written in its look page.
109
+ - **Applies when:** Lit 3D looks with post. Stylised looks may skip bloom entirely, and a recorder or lens look that blooms everything states so and caps the glow instead.
81
110
  - **Verify:** A capture of the brightest lit surface in the level shows no halo; a capture of a muzzle flash or lamp does.
82
111
 
83
- ### Fog is the horizon
84
- - **Invariant:** Fog takes the sky's horizon colour, so distant geometry dissolves into the sky rather than into a grey or white haze.
85
- - **Technique:** Derive the fog colour from the sky shader's horizon term in code, not as a second constant.
86
- - **Reference configuration:** DK locks fog and horizon to one value. Fog density 0.003 to 0.03 by mood across our games; a white horizon is one of the cheap tells.
87
- - **Applies when:** Any outdoor or large interior scene with fog.
88
- - **Verify:** Capture a long sightline. The farthest geometry's colour converges on the sky behind it.
89
-
90
112
  ### Materials are honest
91
- - **Invariant:** Metalness is fully metal or fully not, roughness never reaches the maximum, and every surface has some variation across it.
92
- - **Technique:** Anything between metal and dielectric comes from a map. Pick roughness by material family. Base colour and emissive maps in sRGB, normal, roughness, metalness and occlusion maps linear.
93
- - **Reference configuration:** Concrete 0.90 to 0.97, painted steel 0.35 to 0.55, gun steel 0.45 to 0.60, chrome trim 0.05 to 0.15. SR's plain props default to 0.78 instead of three's 1.0, and keep normal scale 0.35 to 0.6 with occlusion at 0.25 to 0.55.
94
- - **Applies when:** PBR looks. Toon and flat styles follow their own banding rules.
95
- - **Verify:** List every material at runtime with its metalness and roughness; none is at roughness one without a map, none has a fractional metalness without a map.
113
+ - **Invariant:** Bare metal is metal and everything else is dielectric, any value between is a deliberate entry in the look page or comes from a map, roughness never reaches the maximum, every surface varies across it, and no generated material map goes into the game ungraded.
114
+ - **Technique:** Pick roughness by material family. Base colour and emissive maps in sRGB; normal, roughness, metalness and occlusion maps linear. Grade every generated map before use, since they arrive glossy and fully metal. A paint, lacquer or parkerised coat over steel reads as coated metal with low metalness and the form put into its colour. Give painted panels a roughness floor so they do not mirror the sky.
115
+ - **Reference configuration:** Concrete 0.90 to 0.97, painted steel 0.35 to 0.55, gun steel 0.45 to 0.60, chrome trim 0.05 to 0.15. SR's plain props default to 0.78 instead of three's 1.0, with normal scale 0.35 to 0.6 and occlusion at 0.25 to 0.55. LC's generated weapons arrived near roughness 0.35, fully metal, and read as "wet tar and orange"; graded to steel at 0.55 to 0.67 with metal only on bare wear and normal tilt halved. Under a flat fill a coat at metalness 0.9 was "a black cut-out", so LC's coats sit at 0.1 to 0.3, which is why this rule allows a written in-between value. OS's painted panels at roughness 0.28 to 0.32 mirrored the sky probe as blotches until 0.5 to 0.55.
116
+ - **Applies when:** PBR looks, and every game using generated textures. Toon and flat styles follow their own banding rules.
117
+ - **Verify:** List every material at runtime with its metalness and roughness: none is at roughness one without a map, and every in-between metalness is either mapped or listed in the look page.
118
+
119
+ ### Dark surfaces get dark through sheen and light, never through albedo
120
+ - **Invariant:** A dark material reads dark at every distance the camera reaches while its albedo stays above the floor for its family, and no albedo is ever lowered to answer a hot spot under auto-exposure.
121
+ - **Technique:** For matte black and char, lower the specular response (F0 and F90) or use a coloured metal, since a dielectric reflects a fixed few percent of a lamp whatever its colour. Hold albedo floors per surface family, measured at player height. When a surface burns out under a near light, change the light, its falloff or the exposure ceiling, not the texture.
122
+ - **Reference configuration:** LC: a dielectric reflects about 4% of a lamp untinted, ten times a 0.004 char albedo, so three leads tuned albedo from 0.03 to 0.002 and nothing changed; char needed F0 and F90 times 0.12. LC's first minute became "a clay model" after surfaces were darkened step by step to 2 to 3% albedo, each step answering a board that burnt out under the torch while the sensor reopened; fixed with gain 2.6, a roughness floor of 0.6 and sheen 0.12 (wood 5 to 8%, cloth about 10%). OS measured asphalt at 2% and lawn at 0.03, then set floors of 0.08 for day surfaces, 0.13 for up-facing ground and 0.07 for grass, and made dark "metals" dielectric.
123
+ - **Applies when:** Every PBR game with dark materials, near lights or auto-exposure.
124
+ - **Verify:** Sweep the material's luminance at three distances under the game's own light (LC used 0.7, 1.3 and 2.5 m), sweeping albedo and sheen separately: it holds its band at all three with albedo above the floor.
125
+
126
+ ### Materials before props, in one detail language
127
+ - **Invariant:** Every hero surface holds up at 1:1 from standing distance with no visible repeat and real normal and roughness, and cliffs, rock, architecture, foliage and backdrop share one scale of finish, before any dressing pass is judged.
128
+ - **Technique:** Per-map material sets with a macro-variation layer, a detail layer and several variants per wall. Keep tiles non-directional: soot runs, strata and tracks go in vertex colour, decals or broad noise. Match the scale of detail to the object's scale. Then dress densely, inside the keep-outs (`opengame-maps`). When adding props stops moving the score, the bottleneck is the materials.
129
+ - **Reference configuration:** OS: judges' sub-scores correlated with the overall visual at 0.96 for materials, 0.86 for dressing, 0.79 for lighting and 0.45 for foliage and terrain. Roof clutter, banners and 48 decals moved one map down with all three judges: "More props didn't move the needle. All three judges name the same bottleneck: MATERIALS." Once materials held, dressing paid (47 to 131 props, plus 1.4 and 1.0 in paired judging). One map drew "fine masonry applied to monumental blocks"; soot in a 4 m tile became "vertical stripes". Early on, lighting was the cheapest first lift.
130
+ - **Applies when:** A visual score plateaus, or before any environment dressing pass.
131
+ - **Verify:** A 1:1 crop sheet of every hero material at 1080p from 2 m with its repeat period marked, and grazing frames at two and four times the tile size showing no grid.
96
132
 
97
133
  ### Break the tiling
98
134
  - **Invariant:** No texture repeat is visible at play distance.
99
- - **Technique:** A world-space triplanar detail normal that fades with distance, plus very low frequency mottling of albedo and roughness. Normalise a detail texture by its mean luminance so it adds grain without darkening.
100
- - **Reference configuration:** DK: detail normal at 2.6 tiles per metre, strength 0.55, faded from 3.5 to 13 m; macro mottling at about 18 m, albedo plus or minus 16%, roughness plus or minus 12%. Anisotropy 8 to 16 on ground and repeated detail.
135
+ - **Technique:** A world-space triplanar detail normal that fades with distance, plus very low frequency mottling of albedo and roughness; normalise a detail texture by its mean luminance so it adds grain without darkening. Layer repeat lengths that are not multiples of each other, add a second read rotated and larger, offset UVs per box or plank, never mirror a photographic read (it flips the light baked into it), and swap rather than re-tile a scan with a memorable motif.
136
+ - **Reference configuration:** DK: detail normal at 2.6 tiles per metre, strength 0.55, faded from 3.5 to 13 m; macro mottling at about 18 m, albedo plus or minus 16%, roughness plus or minus 12%; anisotropy 8 to 16. OS: repeat lengths 5.0 and 4.3 m, dirt had repeated every 18 m, and anti-tile weights pinned to 0 and 1 at step ends took 5,843 spike pixels to 0. LC: every board of a wall was the same strip of one plank until each box got its own offset and a second sample 4 times larger and rotated.
101
137
  - **Applies when:** Large textured surfaces: ground, walls, terrain.
102
138
  - **Verify:** A wide capture of the largest surface from standing height shows no grid of repeats.
103
139
 
104
140
  ### Detail does not shimmer
105
141
  - **Invariant:** Surfaces do not crawl with bright dashes or sparkle as the camera moves.
106
- - **Technique:** Band-limit generated height fields (blur before deriving normals) so the mip chain has something to average, then fade normal detail where a pixel covers more relief than it can show, and widen roughness by a local average of normal variance.
107
- - **Reference configuration:** DK: blurring prop height fields before the Sobel pass was the largest single win at a bridge doorway (32% off the oscillation). Raising specular antialiasing strength instead made it monotonically worse (3.43 to 5.24 at above 8/255), because the derivative of an aliasing normal is itself aliasing.
108
- - **Applies when:** Any normal-mapped surface, generated textures above all.
109
- - **Verify:** Record a slow pan at a grazing angle and difference consecutive frames; the flicker is measurable and should fall after the fix.
142
+ - **Technique:** First tell aliasing from a depth tie: if the crawl vanishes with temporal anti-aliasing off it is aliasing, and if stepping the near plane re-rolls it it is a tie (`opengame-scene-audit` films both). Band-limit generated height fields (blur before deriving normals) so the mip chain has something to average, fade normal detail and noise where a pixel covers more relief than it can show (screen derivatives), keep normals from facing away from the viewer, and widen roughness by a local average of normal variance.
143
+ - **Reference configuration:** DK: blurring prop height fields before the Sobel pass was the largest single win at a bridge doorway (32% off the oscillation); raising specular antialiasing strength made it monotonically worse (3.43 to 5.24 at above 8/255). LC's reported "zfightin" was snow-edge noise ("a 2 cm crest is four pixels by one"), normal relief under a lamp at the lens and ground relief, "nine guesses before that were wrong"; fading relief between 2 and 7 cm of ground per pixel took flips from 1.64 to 0.00 per 1000 pixels walking.
144
+ - **Applies when:** Any normal-mapped surface, generated textures, snow and fine relief above all.
145
+ - **Verify:** Film a slow pan at a grazing angle on a stepped clock and difference consecutive frames; the flicker count falls after the fix.
146
+
147
+ ### Thin detail is filtered at the source, never widened or dithered
148
+ - **Invariant:** No wire, railing, slat, shingle, grate or card is thinner than about a pixel at the distance it is seen without a far substitute, so nothing crawls under temporal anti-aliasing even when no faces tie.
149
+ - **Technique:** Flatten stepped detail into one plane with the rows in albedo past near range; chamfer thin members; thicken far wires; draw fences as one box-filtered quad that settles to mean coverage; fade periodic relief with distance; sample cut-out alpha a mip or two coarser at range. Do not widen opaque geometry in a shader or dither a level-of-detail swap in screen space: both make it worse.
150
+ - **Reference configuration:** OS: 14 mm shingle risers went "under half a pixel past about 25 m"; flattening took a spot from 970 spike pixels to 0 with fewer triangles. Far wires from 1.5 to 8 cm cut flicker 74 to 79%; louvre ribs from 6 to 15 cm took a spot from 11,133 to 7; coarser alpha mips cut 32 to 37%. Opaque widening to 1.25 px made strafes 48% worse, a screen-space dither drew a "crawling dot net", and shader-wide fixes were reverted twice. The owner rejects dither and ghosting.
151
+ - **Applies when:** Temporal-AA renderers with long sightlines, scopes, industrial kits or alpha-tested plants.
152
+ - **Verify:** The same stepped motion path before and after, with a kill switch, plus a close still showing the surface still reads.
153
+
154
+ ### Foliage keeps its form under motion, zoom and every quality tier
155
+ - **Invariant:** Vegetation never pops, slides, darkens at range or thins as the player moves, aims through a scope or drops quality, and plants that hide players or block sightlines keep their silhouette on every tier.
156
+ - **Technique:** Pick level of detail from straight-line distance at the unzoomed field of view, scaled while zoomed by min(1, tan(fov/2) / tan(hip/2)). Seed each instance's fade distance in world space. Make lower levels exact subsets of the top level's cards, and cull at range rather than draw a dark far version. Keep the distances of cover plants the same on every tier, and save cost with impostors, opaque cores and occluders, not thinning. Bleed leaf colour into the transparent texels so cards have no dark fringe. Ground every plant on its drawn base (`opengame-scene-audit`).
157
+ - **Reference configuration:** OS: "these patches of grass ... as u get closer they move way too much and look very srange ... like they keep flickering" (owner). Tufts had hard-swapped at 5 to 8 m and spruces at 12 to 22 m, and patches faded as the scope closed; after the fix GPU went from 9.3 to 4.3 ms on one map and held-frame flicker from 0.28% to 0.11%. "remove all these patches of whatever these black grass things are that turn green when u go closer" (owner), who also hates flat cut-out cards. The low tier turned tree crowns to sticks and let weak machines see through cover. Forest cost fell from 3.18 to 0.72 ms without thinning ("Thinning instances buys nothing" when a draw is a species and a level of detail). LC's firs: a 1,500-triangle trunk, branch slices within 15 m, crossed impostors beyond.
158
+ - **Applies when:** Alpha-tested vegetation, above all with scopes or automatic quality.
159
+ - **Verify:** Walk-toward clips before and after; a zoom sweep on one patch (OS used fields of view 70, 30, 15 and 8); one camera at the top and the lowest tier showing the same cover.
160
+
161
+ ### Near fire is light, not paint
162
+ - **Invariant:** Fire, smoke and similar effects seen near the camera show no card edges, no flat fills and no column seen end-on, stay inside the frame budget, and a stream leaves the nozzle on every frame the trigger is held.
163
+ - **Technique:** Cost any live simulation first; if it does not fit, bake it offline to a flipbook and check its orientation offline. Draw it additive in HDR (white-yellow core, orange, deep red edges), faded against depth, as many small tongues rather than a few big cards, with nothing right at the eye; a stream as a tapered tube or velocity-aligned cards; flames on a burning figure's bones; smoke lit from below; the fire's light from the fixed lamp budget. Cap exposure and bloom near it, and let gameplay wait for the visual. Judge it from the player's own view at their quality tier, never from its side.
164
+ - **Reference configuration:** LC's live volumetric library ran 60.2 fps idle, 20.0 with eight alight and 3.8 with the stream; baked, 60 fps with twelve alight in a 264 KB flipbook. Camera-facing cards seen end-on became "the column on the man", the bake drew upside down for five leads, and the rain veil stippled flames that write no depth. It was made default because it was "still better than the old pale ball", judged from its side, and the owner then said "the falemthrower vfx/visuals literally looks so bad", the fourth note in 27 hours. LC caps a sprite at about an eighth of the frame and keeps flame 0.6 m from the eye.
165
+ - **Applies when:** Flamethrowers, fires, explosions, smoke and magic near the camera.
166
+ - **Verify:** Frames from the player's own view at their tier and window beside the owner's screenshot, and frame time with a dozen emitters live.
167
+
168
+ ### Paint a painterly world in the painting's own space
169
+ - **Invariant:** In a painterly look, strokes live on 2D sheets laid out the way a painting is ("the edge of a house is the edge of its strokes"), not on the faces of 3D blocks, and each place has its own palette, signature landmark and props rather than a recolour.
170
+ - **Technique:** Lay each place's sheets in the passes a painter uses (sketch, wash, masses, touches, details), bake them over several frames with an instanced stroke engine, and cast them back through the lens in one pass, with props and figures on top. Keep a style-to-place table with a colour scheme per place and a signature in the upper third of the frame. When a polish pass gains little, change the method instead of repainting. [references/painterly.md](references/painterly.md) has OH's method.
171
+ - **Reference configuration:** OH: seven repaint passes that painted 3D blocks gained under 0.2 judge points each, about 12.7 hours; the "one long painting" rebuild, from method videos the owner supplied, gained 0.54 in one pass. Six sheets a place, 76 MB (half on Low), at most 900 strokes baked a frame, five reads a pixel. 16 places for 17 styles with the signature at 15% or more of the frame's height; the canyon read only at 9,300 strokes.
172
+ - **Applies when:** Painterly or illustrated worlds, and any stylised look whose passes have stopped paying.
173
+ - **Verify:** Stroke counts per sheet, a 1:1 still beside the reference, and a contact sheet of every place at play framing.
174
+
175
+ ### Fewer, bigger strokes, and paint holds still
176
+ - **Invariant:** Each face is a solid mass of value with a few large strokes over it, no stroke boils or crawls, and consecutive frames differ only by eased motion.
177
+ - **Technique:** Size strokes, ink weight and halftone in screen pixels; fix every stroke's seed; put paper tooth in object space; step effect layers on threes rather than every frame; keep halftone to the core shadow; land background changes on bar boundaries, eased, never as per-beat shake.
178
+ - **Reference configuration:** OH: 480 to 713 large strokes a venue read as structure where 1,704 small ones read flat and 11,979 thin ones read "hairy"; figures went from 685 to 238 strokes; boil is off by default. "the background is hsaking so much and not looking aaa at all and just looks like slop ... so mcuh jitter ... everything neds to show super smooth" (owner); judges had been recommending a decaying 6 px shake until the owner's rule reached their rubric.
179
+ - **Applies when:** Any stylised renderer, and any "jitter" note on a still scene.
180
+ - **Verify:** Frame-difference statistics on a background crop, and a 12-frame strip.
110
181
 
111
182
  ## Further reading
112
183
 
113
- Post that reacts to sprint and damage, lens finish values, and the starter look's
114
- defaults are in [references/post-and-lens.md](references/post-and-lens.md).
184
+ Post that reacts to sprint and damage, lens finish values, the starter look's defaults
185
+ and the look pass are in [references/post-and-lens.md](references/post-and-lens.md).
@@ -0,0 +1,73 @@
1
+ # Matching a reference, measured
2
+
3
+ When the owner hands over a film, a trailer, concept art or a mood board, the reference
4
+ is the acceptance bar. It only works as one once it has been turned into statements and
5
+ numbers, because "make it look like the video" cannot be checked and an adjective in a
6
+ note ("darker", "a bit trippy") cannot be tuned. This is the method LC ended up running
7
+ for its concept film, with OH's and OS's measurements beside it. Study the reference's
8
+ method and measure its picture; never copy its code, art or files into the game.
9
+
10
+ ## 1. Cut the reference into stills you can lay side by side
11
+
12
+ ```bash
13
+ # One frame every five seconds, tiled four by three at 640 by 360 a tile.
14
+ ffmpeg -i reference.mp4 -vf "fps=1/5,scale=640:360,tile=4x3" sheets/sheet-%02d.png
15
+ ```
16
+
17
+ Add six to eight hand-picked stills of the moments that matter most. LC worked from 180
18
+ stills and 10 sheets.
19
+
20
+ ## 2. Find the reference's frames of the same state
21
+
22
+ For each state you work on (rest, aim, reload, night with the lamp off, night with the
23
+ lamp on, an enemy at arm's length, a friend at 3 m), find the reference frames of that
24
+ same state before ruling anything. LC once ruled the resting pistol from the film's
25
+ aiming frames; the owner sent a rest frame, with the pistol in the bottom fifth.
26
+
27
+ ## 3. Measure, layer by layer
28
+
29
+ | Layer | What to measure | Example (game) |
30
+ | --- | --- | --- |
31
+ | Light levels | Box luminance at fixed places, frame median | Forest 0.009 to 0.020 of white, sky 57 to 80 of 255, lamp pool tops 111 to 124 (LC) |
32
+ | Colour of the dark | RGB of the darkest readable surface | Snow at 15 m about (84, 83, 106), lilac (LC) |
33
+ | Surface colour | Channel ratios, not hue by eye | Dirt G/R 0.80, B/R 0.54 (OS) |
34
+ | Held object | Share of frame width, where the hands sit | Pistol 4.7% of the width (LC) |
35
+ | Strokes | Count per face, size in pixels at a known width | 5 to 15 a face at 40 to 120 px on 1600 wide (OH) |
36
+ | Halftone, paper | Dot size, where dots may appear, bare-paper share | About 6 px, core shadow only, 30 to 40% paper (OH) |
37
+ | Lens | Field of view, barrel, rim, fringe | 104 degrees (OH); barrel 0.36, rim 0.885 (LC) |
38
+ | Effects | Each parameter of the effect, with its timing | Tape grain 0.05 at 4 steps per 0.5 s (LC) |
39
+
40
+ ## 4. Write the targets as numbers, and say where the owner overrides
41
+
42
+ Put the numbers in the look page. Where the owner's newer words differ from the
43
+ reference, the owner wins, and the page says so in a sentence. LC's director read the film
44
+ as "a readable cold blue"; the owner's "make it scarier" set the middle of the frame with the
45
+ lamp off to 6 to 9 of 255, and that line in the page names both.
46
+
47
+ Readings move with time of day and weather (LC's night read 11.7 against 15.6 of 255 at
48
+ one stand a weather minute apart), and with the population: an enemy in the beam moved
49
+ LC's meter by 0.8 of a stop. Take readings at a fixed weather time with enemies present.
50
+
51
+ ## 5. Shoot the game the same way and put both in one picture
52
+
53
+ Same state, the owner's window shape, on the owner's path, at native size and
54
+ unbrightened. Reference on the left, game on the right, one image.
55
+
56
+ ## 6. Grade every kind of visible thing
57
+
58
+ An inventory row per kind of thing (each weapon, each enemy, the ground, each prop
59
+ family), marked placeholder, passable or final. Only a close capture beside the
60
+ reference promotes a row. LC ended with 0 of 73 guns final after many "passable" ones,
61
+ and the inventory is what made that honest.
62
+
63
+ ## 7. Judges compare like with like
64
+
65
+ Judges and playtesters compare game frames with reference frames "of the same kind of
66
+ moment", never a still of the game with a frame from a different state.
67
+
68
+ ## What it does not catch
69
+
70
+ The method made LC's darkness, pistol size and lens right. It did not make the hands,
71
+ reloads, finishes or fire right, because those failed at speed and in motion, which
72
+ stills and sheets do not show. Judge anything that moves on film at real speed
73
+ (`opengame-verification`).
@@ -0,0 +1,69 @@
1
+ # A painterly world: OH's method
2
+
3
+ OG Hero (OH) is a five-lane rhythm game drawn as a painting: brush dabs, ink
4
+ outlines, halftone shadows, flat colour and bare paper, seen through a lively wide lens.
5
+ Seven passes that painted strokes onto the faces of 3D blocks each moved the judges'
6
+ mean by under 0.2. The rebuild below, made after the owner supplied videos showing how
7
+ the reference look was made, moved it by 0.54 in one pass. The lesson travels: when a
8
+ polish pass gains little, change the method.
9
+
10
+ ## Name the layers first
11
+
12
+ Write each layer with its technique and a measured number before any code: brush dabs,
13
+ ink outlines, halftone shadows, flat colour, bare paper, rush lines, impact frames,
14
+ written sounds and the lens. Each one is a technique, never a post filter laid over a
15
+ 3D render.
16
+
17
+ ## Strokes are instances, one draw per layer
18
+
19
+ - A stroke is a bent ribbon (six segments) with two paints, a stamp, a seed and a pass
20
+ number. Three tones of light, broken by chance.
21
+ - Stamps are drawn in code into one atlas, so no images are downloaded.
22
+ - Boil is off by default. Seeds are fixed, so a stroke is the same stroke every frame.
23
+
24
+ ## One long painting per place
25
+
26
+ - Each place is six baked sheets (18.9 million texels, 76 MB, half that on Low) laid in
27
+ five passes: sketch, wash, masses, touches, details.
28
+ - At most 900 strokes are baked per frame, so the bake spreads over the first frames.
29
+ - The sheets are cast back through the lens in one pass, five texture reads a pixel.
30
+ - Near ground gets a sheet laid out in the eye's own angles, because it covers four
31
+ hundred to a thousand pixels a metre.
32
+ - Props and figures live on top of the painting, not inside it.
33
+
34
+ ## The frame
35
+
36
+ The play board renders to its own full-resolution target with no lens. The world goes
37
+ through the lens (in the vertex shader, `tan(k*θ)/tan(k*half)` for a 104 degree lens)
38
+ into a target that can shrink on slower machines. One print pass composites both. Canvas
39
+ antialias, depth and stencil are off.
40
+
41
+ ## What read as paint
42
+
43
+ | Choice | What happened |
44
+ | --- | --- |
45
+ | 480 to 713 large strokes a venue over solid masses | Read as structure |
46
+ | 1,704 small strokes | Read flat |
47
+ | 11,979 thin strokes | Read "hairy" |
48
+ | Figures cut from 685 to 238 strokes | Read as painted figures |
49
+ | Halftone about 6 px, core shadow only | Read as print |
50
+ | Ink weighted in screen pixels | Held its weight at every distance |
51
+ | 30 to 40% bare paper | Read as a painting rather than a coloured render |
52
+ | Figures in two flat values | Read at play size |
53
+
54
+ The reference street held about 21,800 strokes. The canyon place read only once it was
55
+ painted at density, from 3,300 to 9,300 strokes (an 11.1 ms bake).
56
+
57
+ ## A place per style
58
+
59
+ 17 musical styles map to 16 places. Each place has a scheme: three values, accents, a
60
+ mid-dark board, its largest colour mass and a pair for the power mode. Each has a
61
+ signature landmark in the upper third at 15% or more of the frame's height. Once the
62
+ data model existed, six places took 38 minutes. A white hero needs a dark shape behind
63
+ its head.
64
+
65
+ ## Light figures about the line to the eye
66
+
67
+ Under a wide lens, light in camera space lights every surface off axis from the front.
68
+ OH builds each figure's light from `cross(up, toEye)` per fragment and uses two flat
69
+ values with one drawn edge (`opengame-lighting` has the rule).
@@ -1,7 +1,7 @@
1
1
  # Post that reacts, and the lens finish
2
2
 
3
3
  All values here are reference configurations from our games. Start from them, then tune
4
- by eye against the look bible, at play distance, while moving.
4
+ by eye against the look page, at play distance, while moving.
5
5
 
6
6
  ## Lens finish
7
7
 
@@ -26,7 +26,8 @@ AW is the restrained end, DK the hotter one. Pick one for the game and keep it.
26
26
  - **Missing health:** up to vignette +0.3, aberration +0.16, and saturation down 35%.
27
27
  - **Damage:** tint the frame edge by (1.25, 0.22, 0.18), decaying at 3.2 per second.
28
28
  - **Exposure flash:** each shot adds 0.07 of exposure (a heavy shot 0.16), decaying at 7
29
- per second.
29
+ per second. This is for a fixed exposure. A game whose exposure adapts adds no kick for a
30
+ shot: the flash is a light, and the meter's dip after it is capped (`opengame-lighting`).
30
31
 
31
32
  These are DK and AW's numbers. Every one of them must stay inside the flash limits in
32
33
  `opengame-accessibility`: a full-screen change is bounded per frame however it is driven.
@@ -63,4 +64,10 @@ At play distance, on the real route:
63
64
  6. The grade adds contrast without hiding threats, UI or team colours.
64
65
  7. Only emissive and specular sources bloom.
65
66
  8. A capture with the grade off is compared, and the clearer one kept.
66
- 9. The lowest quality tier still reads.
67
+ 9. The lowest quality tier still reads, and keeps every plant and prop that hides a
68
+ player.
69
+ 10. Every weather preset and every camera the game uses (spawn cinematics, the pre-match
70
+ screen, menus) passes the same list, not only clear weather in play.
71
+ 11. Nothing crawls on a slow pan filmed on a stepped clock; stills do not count for
72
+ this one.
73
+ 12. Hero materials hold at 1:1 from standing distance before any dressing is judged.
@@ -0,0 +1,9 @@
1
+ # opengame-maps changelog
2
+
3
+ ## 1.0.0
4
+
5
+ First release. Eight rules from OG Snipers and Last Contact: a written map spec with scale
6
+ from two anchors, the world built and tested as numbers before art, parity as a written
7
+ list of what a player can do with a camera on each item, lanes, sightlines and perches as
8
+ numbers, spawns in open supported space, spawn coverage from every standpoint, guidance by
9
+ light, and visual targets painted over the build's own frames.