evomeme 0.1.9 → 0.1.10-beta.3

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 (406) hide show
  1. package/dist/canvas-public/app.js +509 -5999
  2. package/dist/canvas-public/assets/presets/catalog.json +47 -0
  3. package/dist/canvas-public/assets/presets/tiles/A_01_CaoDi.png +0 -0
  4. package/dist/canvas-public/assets/presets/tiles/A_02_ShaMo.png +0 -0
  5. package/dist/canvas-public/assets/presets/tiles/A_03_TianKong.png +0 -0
  6. package/dist/canvas-public/assets/presets/tiles/A_04_ShuiBo.png +0 -0
  7. package/dist/canvas-public/assets/presets/tiles/A_05_HaiMian.png +0 -0
  8. package/dist/canvas-public/assets/presets/tiles/A_06_MuDiBan.png +0 -0
  9. package/dist/canvas-public/assets/presets/tiles/A_07_ShiZhuan.png +0 -0
  10. package/dist/canvas-public/assets/presets/tiles/A_08_AnRongYan.png +0 -0
  11. package/dist/canvas-public/assets/presets/tiles/A_09_QingTaiShi.png +0 -0
  12. package/dist/canvas-public/assets/presets/tiles/A_10_ShenHai.png +0 -0
  13. package/dist/canvas-public/assets/presets/tiles/A_11_HuiYanShi.png +0 -0
  14. package/dist/canvas-public/assets/presets/tiles/A_12_HongTu.png +0 -0
  15. package/dist/canvas-public/assets/presets/tiles/A_13_GengDi.png +0 -0
  16. package/dist/canvas-public/assets/presets/tiles/A_14_HuoShanYan.png +0 -0
  17. package/dist/canvas-public/assets/presets/tiles/A_15_NiTu.png +0 -0
  18. package/dist/canvas-public/assets/presets/tiles/A_16_HuangSha.png +0 -0
  19. package/dist/canvas-public/assets/presets/tiles/A_17_CongLin.png +0 -0
  20. package/dist/canvas-public/assets/presets/tiles/A_18_ZiYanShi.png +0 -0
  21. package/dist/canvas-public/assets/presets/tiles/A_19_MoGuTu.png +0 -0
  22. package/dist/canvas-public/assets/presets/tiles/A_20_HuaDian.png +0 -0
  23. package/dist/canvas-public/assets/presets/tiles/A_21_HaiLang.png +0 -0
  24. package/dist/canvas-public/assets/presets/tiles/A_22_GanTu.png +0 -0
  25. package/dist/canvas-public/assets/presets/tiles/A_23_QingTaiShiBan.png +0 -0
  26. package/dist/canvas-public/assets/presets/tiles/A_24_XingKong.png +0 -0
  27. package/dist/canvas-public/assets/presets/tiles/A_25_MoFaFuWen.png +0 -0
  28. package/dist/canvas-public/assets/presets/tiles/A_26_ShiTuYeDi.png +0 -0
  29. package/dist/canvas-public/assets/presets/tiles/A_27_LanZhuan.png +0 -0
  30. package/dist/canvas-public/assets/presets/tiles/A_28_HongZhuan.png +0 -0
  31. package/dist/canvas-public/assets/presets/tiles/A_29_YueQiu.png +0 -0
  32. package/dist/canvas-public/assets/presets/tiles/A_30_JinShuGe.png +0 -0
  33. package/dist/canvas-public/assets/presets/tiles/A_31_JinShuJingGai.png +0 -0
  34. package/dist/canvas-public/assets/presets/tiles/A_32_ShuZiChuang.png +0 -0
  35. package/dist/canvas-public/canvas/actions.js +143 -0
  36. package/dist/canvas-public/canvas/camera.js +28 -0
  37. package/dist/canvas-public/canvas/chrome.js +13 -0
  38. package/dist/canvas-public/canvas/data.js +123 -0
  39. package/dist/canvas-public/canvas/dependencies.js +19 -0
  40. package/dist/canvas-public/canvas/interactions.js +544 -0
  41. package/dist/canvas-public/canvas/panel-resize.js +5 -0
  42. package/dist/canvas-public/canvas/renderer.js +297 -0
  43. package/dist/canvas-public/canvas/selection.js +62 -0
  44. package/dist/canvas-public/canvas/serialization.js +118 -0
  45. package/dist/canvas-public/canvas/sync.js +202 -0
  46. package/dist/canvas-public/core/api.js +27 -0
  47. package/dist/canvas-public/core/feature-registry.js +29 -0
  48. package/dist/canvas-public/core/feature-state.js +228 -0
  49. package/dist/canvas-public/core/layout.js +133 -0
  50. package/dist/canvas-public/core/operations.js +38 -0
  51. package/dist/canvas-public/core/project.js +203 -0
  52. package/dist/canvas-public/core/state.js +27 -0
  53. package/dist/canvas-public/dialogs/context-menu.js +118 -0
  54. package/dist/canvas-public/elements/base.js +100 -0
  55. package/dist/canvas-public/elements/connections.js +105 -0
  56. package/dist/canvas-public/elements/drag.js +53 -0
  57. package/dist/canvas-public/elements/image.js +259 -0
  58. package/dist/canvas-public/elements/loading-recovery.js +5 -0
  59. package/dist/canvas-public/elements/loading.js +21 -0
  60. package/dist/canvas-public/elements/map.js +64 -0
  61. package/dist/canvas-public/elements/registry.js +58 -0
  62. package/dist/canvas-public/elements/replacement.js +78 -0
  63. package/dist/canvas-public/elements/resize.js +210 -0
  64. package/dist/canvas-public/elements/task-pipeline.js +234 -0
  65. package/dist/canvas-public/elements/types.js +21 -0
  66. package/dist/canvas-public/elements/ui.js +14 -0
  67. package/dist/canvas-public/elements/video.js +64 -0
  68. package/dist/canvas-public/features/assets/local-assets.js +72 -0
  69. package/dist/canvas-public/features/assets/official-assets.js +538 -0
  70. package/dist/canvas-public/features/editing/canvas-size.js +532 -0
  71. package/dist/canvas-public/features/editing/color-key.js +469 -0
  72. package/dist/canvas-public/features/editing/cutout.js +20 -0
  73. package/dist/canvas-public/features/editing/interactive-image-editing.js +981 -0
  74. package/dist/canvas-public/features/editing/layer-decomposition.js +44 -0
  75. package/dist/canvas-public/features/editing/manual-split.js +114 -0
  76. package/dist/canvas-public/features/editing/perfect-pixel.js +336 -0
  77. package/dist/canvas-public/features/editing/scroll-preview.js +129 -0
  78. package/dist/canvas-public/features/editing/scroll-seam-elimination.js +71 -0
  79. package/dist/canvas-public/features/editing/seam-elimination.js +46 -0
  80. package/dist/canvas-public/features/editing/smart-split.js +48 -0
  81. package/dist/canvas-public/features/editing/source-preview.js +43 -0
  82. package/dist/canvas-public/features/editing/video-cycle.js +49 -0
  83. package/dist/canvas-public/features/editing/video-frames.js +35 -0
  84. package/dist/canvas-public/features/frame-editor/frame-editing.js +755 -0
  85. package/dist/canvas-public/features/frame-editor/frame-model.js +63 -0
  86. package/dist/canvas-public/features/frame-editor/playback.js +83 -0
  87. package/dist/canvas-public/features/frame-editor/preview.js +149 -0
  88. package/dist/canvas-public/features/generation/animation.js +272 -0
  89. package/dist/canvas-public/features/generation/asset-batch.js +102 -0
  90. package/dist/canvas-public/features/generation/direction.js +163 -0
  91. package/dist/canvas-public/features/generation/fields.js +73 -0
  92. package/dist/canvas-public/features/generation/game-ui.js +64 -0
  93. package/dist/canvas-public/features/generation/image.js +96 -0
  94. package/dist/canvas-public/features/generation/scroll-image.js +157 -0
  95. package/dist/canvas-public/features/generation/seamless-tile.js +52 -0
  96. package/dist/canvas-public/features/generation/tile-transition-atlas.js +79 -0
  97. package/dist/canvas-public/features/generation/video.js +105 -0
  98. package/dist/canvas-public/features/map/creation.js +73 -0
  99. package/dist/canvas-public/features/map/tile-map-editor.js +2518 -0
  100. package/dist/canvas-public/features/registry.js +59 -0
  101. package/dist/canvas-public/index.html +84 -259
  102. package/dist/canvas-public/inspector/controls.js +49 -0
  103. package/dist/canvas-public/inspector/frame-preview.js +11 -0
  104. package/dist/canvas-public/inspector/inspector.js +190 -0
  105. package/dist/canvas-public/inspector/media-inspector.js +517 -0
  106. package/dist/canvas-public/inspector/media-preview.js +56 -0
  107. package/dist/canvas-public/inspector/number-stepper.js +96 -0
  108. package/dist/canvas-public/inspector/resize.js +88 -0
  109. package/dist/canvas-public/inspector/scroll-preview.js +11 -0
  110. package/dist/canvas-public/inspector/ui-inspector.js +14 -0
  111. package/dist/canvas-public/language/en-US.js +1059 -0
  112. package/dist/canvas-public/language/index.js +79 -0
  113. package/dist/canvas-public/language/zh-CN.js +1059 -0
  114. package/dist/canvas-public/map/export.js +9 -0
  115. package/dist/canvas-public/map/inspector.js +8 -0
  116. package/dist/canvas-public/map/model.js +409 -0
  117. package/dist/canvas-public/map/tile-map-editor.js +2 -0
  118. package/dist/canvas-public/media/metadata.js +183 -0
  119. package/dist/canvas-public/media/support.js +183 -0
  120. package/dist/canvas-public/styles/base.css +49 -0
  121. package/dist/canvas-public/styles/canvas.css +127 -0
  122. package/dist/canvas-public/styles/controls.css +203 -0
  123. package/dist/canvas-public/styles/dialogs.css +521 -0
  124. package/dist/canvas-public/styles/feature-form.css +409 -0
  125. package/dist/canvas-public/styles/inspector.css +441 -0
  126. package/dist/canvas-public/styles/layout.css +344 -0
  127. package/dist/canvas-public/styles/map.css +11 -0
  128. package/dist/canvas-public/styles/nodes.css +636 -0
  129. package/dist/canvas-public/styles.css +9 -2247
  130. package/dist/canvas-public/ui/controls.js +222 -0
  131. package/dist/canvas-public/ui/elements.js +9 -0
  132. package/dist/canvas-public/ui/feature-controller.js +296 -0
  133. package/dist/canvas-public/ui/feature-form.js +401 -0
  134. package/dist/canvas-public/ui/settings.js +83 -0
  135. package/dist/canvas-public/ui/toolbar.js +55 -0
  136. package/dist/canvas-public/vendor/pixi-tilemap.js +126 -0
  137. package/dist/canvas-public/vendor/pixi.min.js +2340 -0
  138. package/dist/canvas-public/workers/color-key-worker.js +289 -0
  139. package/dist/canvas-public/workers/perfect-pixel-worker.js +510 -0
  140. package/dist/index.js +42004 -12938
  141. package/dist/skills/en-US/evomeme-canvas/SKILL.md +52 -0
  142. package/dist/skills/en-US/evomeme-canvas/agents/openai.yaml +7 -0
  143. package/dist/skills/en-US/evomeme-cloud-fs/SKILL.md +197 -0
  144. package/dist/skills/en-US/evomeme-cloud-fs/agents/openai.yaml +7 -0
  145. package/dist/skills/en-US/evomeme-cover/SKILL.md +131 -0
  146. package/dist/skills/en-US/evomeme-cover/agents/openai.yaml +7 -0
  147. package/dist/skills/en-US/evomeme-game-maker/SKILL.md +288 -0
  148. package/dist/skills/en-US/evomeme-game-maker/agents/openai.yaml +4 -0
  149. package/dist/skills/en-US/evomeme-login/SKILL.md +92 -0
  150. package/dist/skills/en-US/evomeme-login/agents/openai.yaml +7 -0
  151. package/dist/skills/en-US/evomeme-native-bridge-sdk/SKILL.md +286 -0
  152. package/dist/skills/en-US/evomeme-native-bridge-sdk/agents/openai.yaml +8 -0
  153. package/dist/skills/en-US/evomeme-tos-upload/SKILL.md +47 -0
  154. package/dist/skills/en-US/evomeme-tos-upload/agents/openai.yaml +5 -0
  155. package/dist/skills/en-US/evomeme-ui/SKILL.md +123 -0
  156. package/dist/skills/en-US/evomeme-ui/agents/openai.yaml +4 -0
  157. package/dist/skills/en-US/evomeme-ui/references/host-layout.md +69 -0
  158. package/dist/skills/en-US/game-art/SKILL.md +121 -0
  159. package/dist/skills/en-US/game-art/agents/openai.yaml +8 -0
  160. package/dist/skills/en-US/game-asset-align/SKILL.md +45 -0
  161. package/dist/skills/en-US/game-asset-align/agents/openai.yaml +8 -0
  162. package/dist/skills/en-US/game-asset-align/references/alignment-contract.md +61 -0
  163. package/dist/skills/en-US/game-asset-align/references/blender-scene-pipeline.md +45 -0
  164. package/dist/skills/en-US/game-asset-align/references/canonical-package.md +26 -0
  165. package/dist/skills/en-US/game-asset-align/references/engine-capabilities.md +14 -0
  166. package/dist/skills/en-US/game-asset-align/references/lightweight-review.md +32 -0
  167. package/dist/skills/en-US/game-asset-align/references/repair-policy.md +30 -0
  168. package/dist/skills/en-US/game-asset-align/references/tool-contract.md +39 -0
  169. package/dist/skills/en-US/game-asset-align/references/visual-review.md +26 -0
  170. package/dist/skills/en-US/game-asset-image-generator/SKILL.md +64 -0
  171. package/dist/skills/en-US/game-asset-image-generator/agents/openai.yaml +7 -0
  172. package/dist/skills/en-US/game-asset-image-generator/references/background.md +32 -0
  173. package/dist/skills/en-US/game-asset-image-generator/references/static-game-assets.md +38 -0
  174. package/dist/skills/en-US/game-audio/SKILL.md +82 -0
  175. package/dist/skills/en-US/game-audio/agents/openai.yaml +4 -0
  176. package/dist/skills/en-US/game-demo/SKILL.md +103 -0
  177. package/dist/skills/en-US/game-demo/agents/openai.yaml +7 -0
  178. package/dist/skills/en-US/game-maker/SKILL.md +111 -0
  179. package/dist/skills/en-US/game-maker/agents/openai.yaml +4 -0
  180. package/dist/skills/en-US/game-test/SKILL.md +58 -0
  181. package/dist/skills/en-US/game-test/agents/openai.yaml +7 -0
  182. package/dist/skills/en-US/game-ui/SKILL.md +177 -0
  183. package/dist/skills/en-US/game-ui/agents/openai.yaml +4 -0
  184. package/dist/skills/en-US/godot-3d-game/SKILL.md +39 -0
  185. package/dist/skills/en-US/godot-3d-game/agents/openai.yaml +8 -0
  186. package/dist/skills/en-US/godot-3d-game/references/alignment-gates.md +26 -0
  187. package/dist/skills/en-US/godot-3d-game/references/appearance-alignment.md +52 -0
  188. package/dist/skills/en-US/godot-3d-game/references/build-and-qa.md +22 -0
  189. package/dist/skills/en-US/godot-3d-game/references/canonical-asset-runtime.md +27 -0
  190. package/dist/skills/en-US/godot-3d-game/references/import-and-wrapper-scenes.md +20 -0
  191. package/dist/skills/en-US/godot-3d-game/references/physics-colliders.md +13 -0
  192. package/dist/skills/en-US/godot-3d-game/references/project-structure.md +22 -0
  193. package/dist/skills/en-US/godot-3d-game/references/skeleton-animation.md +16 -0
  194. package/dist/skills/en-US/phaser-2d-game/SKILL.md +127 -0
  195. package/dist/skills/en-US/phaser-2d-game/agents/openai.yaml +8 -0
  196. package/dist/skills/en-US/phaser-2d-game/references/engine-performance.md +64 -0
  197. package/dist/skills/en-US/phaser-2d-game/references/engine-physics.md +139 -0
  198. package/dist/skills/en-US/phaser-2d-game/references/engine-runtime.md +129 -0
  199. package/dist/skills/en-US/phaser-2d-game/references/engine-spritesheets.md +99 -0
  200. package/dist/skills/en-US/phaser-2d-game/references/engine-tilemaps.md +80 -0
  201. package/dist/skills/en-US/phaser-2d-game/references/file-structure.md +94 -0
  202. package/dist/skills/en-US/phaser-2d-graphics-builder/SKILL.md +68 -0
  203. package/dist/skills/en-US/phaser-2d-graphics-builder/agents/openai.yaml +7 -0
  204. package/dist/skills/en-US/threejs-3d-game/SKILL.md +117 -0
  205. package/dist/skills/en-US/threejs-3d-game/agents/openai.yaml +7 -0
  206. package/dist/skills/en-US/threejs-3d-game/references/engine-asset-pipeline.md +153 -0
  207. package/dist/skills/en-US/threejs-3d-game/references/engine-audio.md +70 -0
  208. package/dist/skills/en-US/threejs-3d-game/references/engine-input-camera.md +84 -0
  209. package/dist/skills/en-US/threejs-3d-game/references/engine-performance.md +96 -0
  210. package/dist/skills/en-US/threejs-3d-game/references/engine-physics.md +142 -0
  211. package/dist/skills/en-US/threejs-3d-game/references/engine-runtime.md +199 -0
  212. package/dist/skills/en-US/threejs-3d-game/references/file-structure.md +353 -0
  213. package/dist/skills/en-US/threejs-aaa-graphics-builder/SKILL.md +62 -0
  214. package/dist/skills/en-US/threejs-aaa-graphics-builder/agents/openai.yaml +7 -0
  215. package/{skills → dist/skills/zh-CN}/evomeme-cloud-fs/SKILL.md +28 -7
  216. package/{skills → dist/skills/zh-CN}/evomeme-cover/SKILL.md +7 -8
  217. package/{skills → dist/skills/zh-CN}/evomeme-game-maker/SKILL.md +91 -88
  218. package/{skills → dist/skills/zh-CN}/evomeme-tos-upload/SKILL.md +6 -5
  219. package/dist/skills/zh-CN/evomeme-ui/SKILL.md +123 -0
  220. package/dist/skills/zh-CN/evomeme-ui/agents/openai.yaml +4 -0
  221. package/dist/skills/zh-CN/evomeme-ui/references/host-layout.md +69 -0
  222. package/dist/skills/zh-CN/game-asset-align/SKILL.md +45 -0
  223. package/dist/skills/zh-CN/game-asset-align/agents/openai.yaml +8 -0
  224. package/dist/skills/zh-CN/game-asset-align/references/alignment-contract.md +61 -0
  225. package/dist/skills/zh-CN/game-asset-align/references/blender-scene-pipeline.md +45 -0
  226. package/dist/skills/zh-CN/game-asset-align/references/canonical-package.md +26 -0
  227. package/dist/skills/zh-CN/game-asset-align/references/engine-capabilities.md +14 -0
  228. package/dist/skills/zh-CN/game-asset-align/references/lightweight-review.md +32 -0
  229. package/dist/skills/zh-CN/game-asset-align/references/repair-policy.md +30 -0
  230. package/dist/skills/zh-CN/game-asset-align/references/tool-contract.md +39 -0
  231. package/dist/skills/zh-CN/game-asset-align/references/visual-review.md +26 -0
  232. package/dist/skills/zh-CN/game-asset-image-generator/SKILL.md +64 -0
  233. package/{skills → dist/skills/zh-CN}/game-asset-image-generator/references/background.md +1 -1
  234. package/{skills → dist/skills/zh-CN}/game-asset-image-generator/references/static-game-assets.md +2 -2
  235. package/dist/skills/zh-CN/game-audio/references/bgm-cdn.md +127 -0
  236. package/dist/skills/zh-CN/game-audio/references/sfx-cdn.md +77 -0
  237. package/dist/skills/zh-CN/game-test/references/checklists/playtest-qa.md +12 -0
  238. package/{skills → dist/skills/zh-CN}/game-ui/SKILL.md +9 -1
  239. package/dist/skills/zh-CN/game-ui/references/checklists/game-ui-quality.md +14 -0
  240. package/dist/skills/zh-CN/game-ui/references/checklists/hud-readability.md +12 -0
  241. package/dist/skills/zh-CN/game-ui/references/checklists/mobile-input.md +12 -0
  242. package/dist/skills/zh-CN/game-ui/references/checklists/responsive-ui-fit.md +12 -0
  243. package/dist/skills/zh-CN/game-ui/references/ui-patterns.md +140 -0
  244. package/dist/skills/zh-CN/game-ui/references/ui-prompt-templates.md +63 -0
  245. package/dist/skills/zh-CN/godot-3d-game/SKILL.md +39 -0
  246. package/dist/skills/zh-CN/godot-3d-game/agents/openai.yaml +8 -0
  247. package/dist/skills/zh-CN/godot-3d-game/references/alignment-gates.md +26 -0
  248. package/dist/skills/zh-CN/godot-3d-game/references/appearance-alignment.md +52 -0
  249. package/dist/skills/zh-CN/godot-3d-game/references/build-and-qa.md +22 -0
  250. package/dist/skills/zh-CN/godot-3d-game/references/canonical-asset-runtime.md +27 -0
  251. package/dist/skills/zh-CN/godot-3d-game/references/import-and-wrapper-scenes.md +20 -0
  252. package/dist/skills/zh-CN/godot-3d-game/references/physics-colliders.md +13 -0
  253. package/dist/skills/zh-CN/godot-3d-game/references/project-structure.md +22 -0
  254. package/dist/skills/zh-CN/godot-3d-game/references/skeleton-animation.md +16 -0
  255. package/dist/skills/zh-CN/phaser-2d-graphics-builder/assets/scorecard-anchors/scene-1.jpeg +0 -0
  256. package/dist/skills/zh-CN/phaser-2d-graphics-builder/assets/scorecard-anchors/scene-2.jpeg +0 -0
  257. package/dist/skills/zh-CN/phaser-2d-graphics-builder/assets/scorecard-anchors/scene-3.jpg +0 -0
  258. package/dist/skills/zh-CN/phaser-2d-graphics-builder/references/checklists/compose-quality.md +10 -0
  259. package/dist/skills/zh-CN/phaser-2d-graphics-builder/references/checklists/performance-safe-visual-detail.md +9 -0
  260. package/dist/skills/zh-CN/phaser-2d-graphics-builder/references/checklists/premium-game-quality-gate.md +15 -0
  261. package/dist/skills/zh-CN/phaser-2d-graphics-builder/references/checklists/sprite-quality.md +10 -0
  262. package/dist/skills/zh-CN/phaser-2d-graphics-builder/references/checklists/technical-art-quality.md +9 -0
  263. package/dist/skills/zh-CN/phaser-2d-graphics-builder/references/checklists/visual-scorecard.md +9 -0
  264. package/dist/skills/zh-CN/phaser-2d-graphics-builder/references/compose-recipes.md +71 -0
  265. package/dist/skills/zh-CN/phaser-2d-graphics-builder/references/graphics-prompt-templates.md +33 -0
  266. package/dist/skills/zh-CN/phaser-2d-graphics-builder/references/implementation-blueprint.md +82 -0
  267. package/dist/skills/zh-CN/phaser-2d-graphics-builder/references/sprite-recipes.md +90 -0
  268. package/dist/skills/zh-CN/phaser-2d-graphics-builder/references/technical-art.md +67 -0
  269. package/dist/skills/zh-CN/phaser-2d-graphics-builder/references/vfx-recipes.md +67 -0
  270. package/dist/skills/zh-CN/phaser-2d-graphics-builder/references/visual-scorecard.md +129 -0
  271. package/{skills → dist/skills/zh-CN}/threejs-3d-game/SKILL.md +6 -2
  272. package/{skills → dist/skills/zh-CN}/threejs-3d-game/references/engine-asset-pipeline.md +52 -15
  273. package/dist/skills/zh-CN/threejs-aaa-graphics-builder/assets/scorecard-anchors/scene-1.jpg +0 -0
  274. package/dist/skills/zh-CN/threejs-aaa-graphics-builder/assets/scorecard-anchors/scene-2.jpg +0 -0
  275. package/dist/skills/zh-CN/threejs-aaa-graphics-builder/assets/scorecard-anchors/scene-3.jpg +0 -0
  276. package/dist/skills/zh-CN/threejs-aaa-graphics-builder/references/checklists/aaa-game-quality-gate.md +23 -0
  277. package/dist/skills/zh-CN/threejs-aaa-graphics-builder/references/checklists/aaa-visual-scorecard.md +19 -0
  278. package/dist/skills/zh-CN/threejs-aaa-graphics-builder/references/checklists/material-lighting-quality.md +14 -0
  279. package/dist/skills/zh-CN/threejs-aaa-graphics-builder/references/checklists/performance-safe-visual-detail.md +14 -0
  280. package/dist/skills/zh-CN/threejs-aaa-graphics-builder/references/checklists/procedural-model-quality.md +15 -0
  281. package/dist/skills/zh-CN/threejs-aaa-graphics-builder/references/checklists/technical-art-quality.md +17 -0
  282. package/dist/skills/zh-CN/threejs-aaa-graphics-builder/references/graphics-prompt-templates.md +236 -0
  283. package/dist/skills/zh-CN/threejs-aaa-graphics-builder/references/implementation-blueprint.md +161 -0
  284. package/dist/skills/zh-CN/threejs-aaa-graphics-builder/references/model-recipes.md +146 -0
  285. package/dist/skills/zh-CN/threejs-aaa-graphics-builder/references/render-recipes.md +90 -0
  286. package/dist/skills/zh-CN/threejs-aaa-graphics-builder/references/shader-cookbook.md +292 -0
  287. package/dist/skills/zh-CN/threejs-aaa-graphics-builder/references/technical-art.md +167 -0
  288. package/dist/skills/zh-CN/threejs-aaa-graphics-builder/references/visual-scorecard.md +147 -0
  289. package/dist/stage-blender/bake_materials.py +102 -0
  290. package/dist/stage-blender/export_scene.py +275 -0
  291. package/dist/stage-blender/preview_camera.py +90 -0
  292. package/dist/stage-blender/repair_mesh.py +112 -0
  293. package/dist/stage-public/app.js +759 -0
  294. package/dist/stage-public/baked/bakePilot.js +44 -0
  295. package/dist/stage-public/baked/bakedScene.js +129 -0
  296. package/dist/stage-public/baked/sceneAppearance.js +225 -0
  297. package/dist/stage-public/baked/sceneCamera.js +45 -0
  298. package/dist/stage-public/comparison-contract.js +28 -0
  299. package/dist/stage-public/delivery.html +4 -0
  300. package/dist/stage-public/delivery.js +17 -0
  301. package/dist/stage-public/godot/appearance.gd +170 -0
  302. package/dist/stage-public/godot/preview.gd +79 -0
  303. package/dist/stage-public/index.html +141 -0
  304. package/dist/stage-public/review-app.js +289 -0
  305. package/dist/stage-public/review-runtime.js +63 -0
  306. package/dist/stage-public/review.css +24 -0
  307. package/dist/stage-public/review.html +47 -0
  308. package/dist/stage-public/scene-runtime.js +212 -0
  309. package/dist/stage-public/sceneContractRuntime.js +235 -0
  310. package/dist/stage-public/styles.css +328 -0
  311. package/dist/stage-public/three-appearance.js +104 -0
  312. package/dist/stage-public/vendor/three170/LICENSE +21 -0
  313. package/dist/stage-public/vendor/three170/build/three.module.js +54571 -0
  314. package/dist/stage-public/vendor/three170/examples/jsm/controls/OrbitControls.js +1523 -0
  315. package/dist/stage-public/vendor/three170/examples/jsm/environments/RoomEnvironment.js +144 -0
  316. package/dist/stage-public/vendor/three170/examples/jsm/libs/fflate.module.js +2672 -0
  317. package/dist/stage-public/vendor/three170/examples/jsm/loaders/EXRLoader.js +2563 -0
  318. package/dist/stage-public/vendor/three170/examples/jsm/loaders/GLTFLoader.js +4727 -0
  319. package/dist/stage-public/vendor/three170/examples/jsm/utils/BufferGeometryUtils.js +1373 -0
  320. package/dist/tile-transition-mask.svg +40 -0
  321. package/package.json +21 -7
  322. package/dist/canvas-public/cycle-detect.js +0 -166
  323. package/dist/canvas-public/smart-split.js +0 -185
  324. package/skills/game-asset-image-generator/SKILL.md +0 -104
  325. /package/{skills → dist/skills/en-US}/game-audio/references/bgm-cdn.md +0 -0
  326. /package/{skills → dist/skills/en-US}/game-audio/references/sfx-cdn.md +0 -0
  327. /package/{skills → dist/skills/en-US}/game-test/references/checklists/playtest-qa.md +0 -0
  328. /package/{skills → dist/skills/en-US}/game-ui/references/checklists/game-ui-quality.md +0 -0
  329. /package/{skills → dist/skills/en-US}/game-ui/references/checklists/hud-readability.md +0 -0
  330. /package/{skills → dist/skills/en-US}/game-ui/references/checklists/mobile-input.md +0 -0
  331. /package/{skills → dist/skills/en-US}/game-ui/references/checklists/responsive-ui-fit.md +0 -0
  332. /package/{skills → dist/skills/en-US}/game-ui/references/ui-patterns.md +0 -0
  333. /package/{skills → dist/skills/en-US}/game-ui/references/ui-prompt-templates.md +0 -0
  334. /package/{skills → dist/skills/en-US}/phaser-2d-graphics-builder/assets/scorecard-anchors/scene-1.jpeg +0 -0
  335. /package/{skills → dist/skills/en-US}/phaser-2d-graphics-builder/assets/scorecard-anchors/scene-2.jpeg +0 -0
  336. /package/{skills → dist/skills/en-US}/phaser-2d-graphics-builder/assets/scorecard-anchors/scene-3.jpg +0 -0
  337. /package/{skills → dist/skills/en-US}/phaser-2d-graphics-builder/references/checklists/compose-quality.md +0 -0
  338. /package/{skills → dist/skills/en-US}/phaser-2d-graphics-builder/references/checklists/performance-safe-visual-detail.md +0 -0
  339. /package/{skills → dist/skills/en-US}/phaser-2d-graphics-builder/references/checklists/premium-game-quality-gate.md +0 -0
  340. /package/{skills → dist/skills/en-US}/phaser-2d-graphics-builder/references/checklists/sprite-quality.md +0 -0
  341. /package/{skills → dist/skills/en-US}/phaser-2d-graphics-builder/references/checklists/technical-art-quality.md +0 -0
  342. /package/{skills → dist/skills/en-US}/phaser-2d-graphics-builder/references/checklists/visual-scorecard.md +0 -0
  343. /package/{skills → dist/skills/en-US}/phaser-2d-graphics-builder/references/compose-recipes.md +0 -0
  344. /package/{skills → dist/skills/en-US}/phaser-2d-graphics-builder/references/graphics-prompt-templates.md +0 -0
  345. /package/{skills → dist/skills/en-US}/phaser-2d-graphics-builder/references/implementation-blueprint.md +0 -0
  346. /package/{skills → dist/skills/en-US}/phaser-2d-graphics-builder/references/sprite-recipes.md +0 -0
  347. /package/{skills → dist/skills/en-US}/phaser-2d-graphics-builder/references/technical-art.md +0 -0
  348. /package/{skills → dist/skills/en-US}/phaser-2d-graphics-builder/references/vfx-recipes.md +0 -0
  349. /package/{skills → dist/skills/en-US}/phaser-2d-graphics-builder/references/visual-scorecard.md +0 -0
  350. /package/{skills → dist/skills/en-US}/threejs-aaa-graphics-builder/assets/scorecard-anchors/scene-1.jpg +0 -0
  351. /package/{skills → dist/skills/en-US}/threejs-aaa-graphics-builder/assets/scorecard-anchors/scene-2.jpg +0 -0
  352. /package/{skills → dist/skills/en-US}/threejs-aaa-graphics-builder/assets/scorecard-anchors/scene-3.jpg +0 -0
  353. /package/{skills → dist/skills/en-US}/threejs-aaa-graphics-builder/references/checklists/aaa-game-quality-gate.md +0 -0
  354. /package/{skills → dist/skills/en-US}/threejs-aaa-graphics-builder/references/checklists/aaa-visual-scorecard.md +0 -0
  355. /package/{skills → dist/skills/en-US}/threejs-aaa-graphics-builder/references/checklists/material-lighting-quality.md +0 -0
  356. /package/{skills → dist/skills/en-US}/threejs-aaa-graphics-builder/references/checklists/performance-safe-visual-detail.md +0 -0
  357. /package/{skills → dist/skills/en-US}/threejs-aaa-graphics-builder/references/checklists/procedural-model-quality.md +0 -0
  358. /package/{skills → dist/skills/en-US}/threejs-aaa-graphics-builder/references/checklists/technical-art-quality.md +0 -0
  359. /package/{skills → dist/skills/en-US}/threejs-aaa-graphics-builder/references/graphics-prompt-templates.md +0 -0
  360. /package/{skills → dist/skills/en-US}/threejs-aaa-graphics-builder/references/implementation-blueprint.md +0 -0
  361. /package/{skills → dist/skills/en-US}/threejs-aaa-graphics-builder/references/model-recipes.md +0 -0
  362. /package/{skills → dist/skills/en-US}/threejs-aaa-graphics-builder/references/render-recipes.md +0 -0
  363. /package/{skills → dist/skills/en-US}/threejs-aaa-graphics-builder/references/shader-cookbook.md +0 -0
  364. /package/{skills → dist/skills/en-US}/threejs-aaa-graphics-builder/references/technical-art.md +0 -0
  365. /package/{skills → dist/skills/en-US}/threejs-aaa-graphics-builder/references/visual-scorecard.md +0 -0
  366. /package/{skills → dist/skills/zh-CN}/evomeme-canvas/SKILL.md +0 -0
  367. /package/{skills → dist/skills/zh-CN}/evomeme-canvas/agents/openai.yaml +0 -0
  368. /package/{skills → dist/skills/zh-CN}/evomeme-cloud-fs/agents/openai.yaml +0 -0
  369. /package/{skills → dist/skills/zh-CN}/evomeme-cover/agents/openai.yaml +0 -0
  370. /package/{skills → dist/skills/zh-CN}/evomeme-game-maker/agents/openai.yaml +0 -0
  371. /package/{skills → dist/skills/zh-CN}/evomeme-login/SKILL.md +0 -0
  372. /package/{skills → dist/skills/zh-CN}/evomeme-login/agents/openai.yaml +0 -0
  373. /package/{skills → dist/skills/zh-CN}/evomeme-native-bridge-sdk/SKILL.md +0 -0
  374. /package/{skills → dist/skills/zh-CN}/evomeme-native-bridge-sdk/agents/openai.yaml +0 -0
  375. /package/{skills → dist/skills/zh-CN}/evomeme-tos-upload/agents/openai.yaml +0 -0
  376. /package/{skills → dist/skills/zh-CN}/game-art/SKILL.md +0 -0
  377. /package/{skills → dist/skills/zh-CN}/game-art/agents/openai.yaml +0 -0
  378. /package/{skills → dist/skills/zh-CN}/game-asset-image-generator/agents/openai.yaml +0 -0
  379. /package/{skills → dist/skills/zh-CN}/game-audio/SKILL.md +0 -0
  380. /package/{skills → dist/skills/zh-CN}/game-audio/agents/openai.yaml +0 -0
  381. /package/{skills → dist/skills/zh-CN}/game-demo/SKILL.md +0 -0
  382. /package/{skills → dist/skills/zh-CN}/game-demo/agents/openai.yaml +0 -0
  383. /package/{skills → dist/skills/zh-CN}/game-maker/SKILL.md +0 -0
  384. /package/{skills → dist/skills/zh-CN}/game-maker/agents/openai.yaml +0 -0
  385. /package/{skills → dist/skills/zh-CN}/game-test/SKILL.md +0 -0
  386. /package/{skills → dist/skills/zh-CN}/game-test/agents/openai.yaml +0 -0
  387. /package/{skills → dist/skills/zh-CN}/game-ui/agents/openai.yaml +0 -0
  388. /package/{skills → dist/skills/zh-CN}/phaser-2d-game/SKILL.md +0 -0
  389. /package/{skills → dist/skills/zh-CN}/phaser-2d-game/agents/openai.yaml +0 -0
  390. /package/{skills → dist/skills/zh-CN}/phaser-2d-game/references/engine-performance.md +0 -0
  391. /package/{skills → dist/skills/zh-CN}/phaser-2d-game/references/engine-physics.md +0 -0
  392. /package/{skills → dist/skills/zh-CN}/phaser-2d-game/references/engine-runtime.md +0 -0
  393. /package/{skills → dist/skills/zh-CN}/phaser-2d-game/references/engine-spritesheets.md +0 -0
  394. /package/{skills → dist/skills/zh-CN}/phaser-2d-game/references/engine-tilemaps.md +0 -0
  395. /package/{skills → dist/skills/zh-CN}/phaser-2d-game/references/file-structure.md +0 -0
  396. /package/{skills → dist/skills/zh-CN}/phaser-2d-graphics-builder/SKILL.md +0 -0
  397. /package/{skills → dist/skills/zh-CN}/phaser-2d-graphics-builder/agents/openai.yaml +0 -0
  398. /package/{skills → dist/skills/zh-CN}/threejs-3d-game/agents/openai.yaml +0 -0
  399. /package/{skills → dist/skills/zh-CN}/threejs-3d-game/references/engine-audio.md +0 -0
  400. /package/{skills → dist/skills/zh-CN}/threejs-3d-game/references/engine-input-camera.md +0 -0
  401. /package/{skills → dist/skills/zh-CN}/threejs-3d-game/references/engine-performance.md +0 -0
  402. /package/{skills → dist/skills/zh-CN}/threejs-3d-game/references/engine-physics.md +0 -0
  403. /package/{skills → dist/skills/zh-CN}/threejs-3d-game/references/engine-runtime.md +0 -0
  404. /package/{skills → dist/skills/zh-CN}/threejs-3d-game/references/file-structure.md +0 -0
  405. /package/{skills → dist/skills/zh-CN}/threejs-aaa-graphics-builder/SKILL.md +0 -0
  406. /package/{skills → dist/skills/zh-CN}/threejs-aaa-graphics-builder/agents/openai.yaml +0 -0
@@ -0,0 +1,167 @@
1
+ # Technical Art For Three.js Games
2
+
3
+ Use this reference before premium/AAA/showcase graphics work, shader/material/post-processing changes, VFX systems, generated/imported asset cleanup, LOD/instancing work, or any visual pass that could affect browser performance.
4
+
5
+ Technical art is the bridge between art direction and real-time constraints. The goal is not maximum detail; it is readable authored detail that survives active gameplay, mobile viewports, and WebGL budgets.
6
+
7
+ Research basis: Three.js exposes renderer diagnostics through `WebGLRenderer.info`; `InstancedMesh` is designed for many objects sharing geometry/materials; `LOD` switches objects by distance; `KTX2Loader` supports Basis Universal GPU texture workflows; MDN WebGL best practices emphasize eliminating errors, understanding system limits, eager deletion, batching draw calls, per-pixel VRAM budgets, smaller back buffers, mipmaps, compressed textures, and high-DPI discipline.
8
+
9
+ ## Technical Art Brief
10
+
11
+ Before implementation, write:
12
+
13
+ - Art direction in renderable terms: shapes, materials, lighting, VFX, camera, UI/world motifs.
14
+ - Hero surfaces: what must look authored at active-play distance.
15
+ - Support surfaces: what can be procedural, instanced, simplified, or culled.
16
+ - Material kit: named roles, not one-off colors.
17
+ - VFX language: event-driven effects and state readability.
18
+ - Lighting stack: key/fill/rim/practical/contact/depth.
19
+ - Render budget target: draw calls, triangles, textures, materials, DPR, shadow/post cost.
20
+ - Asset strategy: procedural / generated 2D / generated 3D / hybrid / imported.
21
+ - Mobile constraint: what changes first if performance or readability fails.
22
+
23
+ ## Render Budget Starting Points
24
+
25
+ These are starting contracts, not universal limits — measure on the target game, and document every deliberate overrun as a tradeoff. The canvas inspector (`pnpm exec node ../game-test/scripts/inspect-threejs-canvas.mjs` when available, or any project `inspect:canvas` script) compares live diagnostics against the same numbers and reports over-budget rows.
26
+
27
+ | Metric (worst active-play view) | Desktop tier | Mobile tier |
28
+ | --- | --- | --- |
29
+ | Draw calls (`info.render.calls`) | <= 300 | <= 150 |
30
+ | Triangles (`info.render.triangles`) | <= 750k | <= 300k |
31
+ | Geometries (`info.memory.geometries`) | <= 300 | <= 200 |
32
+ | Textures (`info.memory.textures`) | <= 60 | <= 40 |
33
+ | Texture memory (est.) | <= 256 MB | <= 128 MB |
34
+ | Shadow-casting lights | <= 2 | 1 |
35
+ | Shadow map size | <= 2048 | <= 1024 |
36
+ | DPR cap | 2 | 1.5-2 |
37
+ | Post passes (beyond render+output) | <= 2 | 0-1 |
38
+
39
+ How to spend within them:
40
+
41
+ - Draw calls: repeated world/detail pieces should be instanced or merged by material.
42
+ - Triangles: spend on silhouettes near the camera; reduce background detail through LOD, impostors, or simplified meshes.
43
+ - Materials: share material roles aggressively. Unique material count often grows faster than geometry count.
44
+ - Textures: keep opaque large images compressed or small; avoid unique 2K+ textures for tiny repeated props.
45
+ - Shadows: reserve real shadows for hero objects and grounding anchors; use blob/contact meshes for small repeated props (see `shader-cookbook.md` for the cheap contact-shadow recipe).
46
+ - Post: every pass must earn its cost and preserve gameplay clarity; concrete chain settings are in `shader-cookbook.md`.
47
+
48
+ Always report actual renderer diagnostics after the graphics pass: calls, triangles, geometries, textures, material count if available, post passes, shadow settings, DPR cap, and bottlenecks.
49
+
50
+ ## Material And Shader System
51
+
52
+ Use a material kit of named shared roles, not one-off colors. Reuse each role across every mesh that plays the same part:
53
+
54
+ - `bodyPrimary`: dominant player/world shell.
55
+ - `bodySecondary`: panel contrast.
56
+ - `trim`: rails, bevel highlights, borders, edge highlights.
57
+ - `hazard`: danger surfaces, damage cues, warning stripes.
58
+ - `reward`: collectible surfaces with readable value.
59
+ - `shieldBoost`: shield, boost, and status states.
60
+ - `glass`: cockpit, shield, lens, visor.
61
+ - `emissiveSignal`: authored glow strips, status lights, beacon cores.
62
+ - `groundContact`: dark matte surfaces and shadow receivers.
63
+ - `decalDark` and `decalLight`: panel lines, scratches, numbers, icons.
64
+ - UI/world signal colors shared between HUD and diegetic markers.
65
+
66
+ Use `MeshStandardMaterial` for most surfaces. Use `MeshPhysicalMaterial` selectively for cockpit glass, clearcoat panels, iridescent shields, or premium hero details. Share materials across repeated meshes.
67
+
68
+ Shader or `onBeforeCompile` work must have a reason:
69
+
70
+ - State readability: shield ripple, heat, cloak, damage pulse.
71
+ - Surface identity: water, forcefield, hologram, scanline, energy core.
72
+ - Performance: cheap procedural variation instead of many textures.
73
+ - Composition: separating player/threat/reward from background.
74
+
75
+ Reject shader work that only adds noise, bloom bait, or hidden cost without improving active-play decisions. When shader work is justified, use the proven recipes in `shader-cookbook.md` (material values, onBeforeCompile patterns, sky, post chain) instead of improvising GLSL.
76
+
77
+ ## VFX Readability
78
+
79
+ Every VFX effect must answer:
80
+
81
+ - What event or state triggers it?
82
+ - What does it tell the player?
83
+ - Does it point to player, threat, reward, objective, or impact?
84
+ - How long does it last?
85
+ - Is it pooled or cheap to recreate?
86
+ - Does it obscure collision, HUD, or the next decision?
87
+ - Is there a reduced-motion fallback for heavy shake/strobe?
88
+
89
+ Use event-driven VFX over permanent particle clutter:
90
+
91
+ - Pickup: ring contraction, shard burst, score trail, brief HUD echo.
92
+ - Hit/fail: impact ring, debris, damage flash, brief hit pause, camera impulse.
93
+ - Boost/speed: engine trail, lane streaks, FOV ease, side streaks, audio pitch.
94
+ - Near miss/combo: side spark, line snap, badge pulse, streak counter.
95
+ - Shield/invulnerable: refractive shell, rim pulse, absorbed-impact ripple, material swap.
96
+ - Spawn/despawn: anticipation pulse, telegraph, dissolve or scale snap.
97
+
98
+ Pool effects and reuse geometries/materials. Permanent particle fields must stay cheap and sparse.
99
+
100
+ ## Instancing, LOD, And Culling
101
+
102
+ Use instancing for many copies with the same geometry/material and different transforms: windows, bolts, lane markers, city lights, debris, foliage-like props, stars, crowd cards, track panels, repeated pickups, background modules.
103
+
104
+ Rules:
105
+
106
+ - Update `instanceMatrix.needsUpdate` and `instanceColor.needsUpdate` only after batched changes.
107
+ - Compute or update bounds for instanced groups when transforms change materially.
108
+ - Do not instance everything blindly. Different materials or constantly changing transforms can erase the win.
109
+ - Keep collision separate from instanced visual detail.
110
+
111
+ Use LOD when:
112
+
113
+ - A hero/background object spans large distance ranges.
114
+ - The silhouette matters near camera but not far away.
115
+ - Imported/generated models are heavier than needed for background use.
116
+
117
+ Rules:
118
+
119
+ - Add hysteresis or distance gaps to reduce visible popping.
120
+ - Use impostor cards or simplified silhouettes for far layers when appropriate.
121
+ - Verify LOD transitions during gameplay camera motion, not only static orbit.
122
+
123
+ ## Generated And Imported Asset Cleanup
124
+
125
+ For every imported GLB/FBX hero asset:
126
+
127
+ - Confirm scale, pivot, forward/up orientation, bounds, and active-play silhouette.
128
+ - Create a simple collision proxy independent from the visual mesh.
129
+ - Inspect file size, approximate triangles, mesh count, material count, texture count, and animation clips when available.
130
+ - Replace or simplify excessive materials and textures.
131
+ - Add LOD or simplified background variant when reused many times.
132
+ - Verify PBR material readability under the game's lighting, not only in a model viewer.
133
+ - Keep API keys and temporary URLs out of client code and checked-in files.
134
+
135
+ ## Decals, Trim, And Surface Detail
136
+
137
+ Prefer reusable surface systems:
138
+
139
+ - Canvas-generated trim sheets for panel lines, markings, arrows, numbers.
140
+ - Thin offset decal meshes for hazard marks, faction symbols, lane glyphs, scuffs.
141
+ - Shared small textures for noise/wear rather than unique full-size images.
142
+ - Procedural UV-independent detail for repeated hard-surface props.
143
+
144
+ Surface detail must reinforce scale, function, faction, route, or state. Do not add random lines everywhere.
145
+
146
+ ## Color And Readability
147
+
148
+ Readability beats palette consistency:
149
+
150
+ - Threats differ from rewards by shape and motion, not only hue.
151
+ - Interactables differ from background by silhouette/value/material.
152
+ - UI signal colors match world signal colors.
153
+ - Bloom/fog/darkness cannot be the primary separator.
154
+ - Colorblind-risk information has shape/icon/motion backup.
155
+
156
+ ## Technical Art Report
157
+
158
+ Report:
159
+
160
+ - Technical art brief.
161
+ - Material kit and shader/VFX decisions.
162
+ - Instancing/LOD/culling strategy.
163
+ - Render budget target and actual diagnostics.
164
+ - Imported/generated asset cleanup evidence.
165
+ - VFX readability checks.
166
+ - Mobile/DPR/post/shadow tradeoffs.
167
+ - Remaining visual performance risks.
@@ -0,0 +1,147 @@
1
+ # Visual Scorecard
2
+
3
+ Score active-play screenshots, not idle title screens or isolated showroom models. Use desktop and mobile screenshots when mobile is in scope.
4
+
5
+ Scores are self-assessed against the anchors below, so they drift optimistic. Two countermeasures are mandatory for premium/AAA/showcase claims: cite Measured Evidence for the categories it supports, and run the Fresh-Eyes Review before finalizing.
6
+
7
+ ## Calibration Anchors
8
+
9
+ Reference screenshots for score calibration are packaged in `threejs-aaa-graphics-builder/assets/scorecard-anchors/`:
10
+
11
+ - `scene-1.jpg` — score ~1: primitive player and pickups on a flat sparse arena, utility HUD.
12
+ - `scene-2.jpg` — score ~2: authored track kit, imported hero asset, designed genre HUD, intentional lighting.
13
+ - `scene-3.jpg` — score ~2.5-3: dense layered world in active play, readable hero silhouette, event VFX, cohesive HUD.
14
+
15
+ Before scoring World/environment, Hero/player, Materials/textures, or Lighting/render, view the anchors and compare: if your screenshot reads closer to `scene-1.jpg` than `scene-3.jpg` for that surface, the category is at most a 1-2 regardless of how much code was written.
16
+
17
+ ## Scoring Scale
18
+
19
+ - 0: Placeholder. Default primitives, sparse world, unreadable state, debug UI, or no evidence.
20
+ - 1: Basic styled. Playable and themed, but still obvious prototype assets, flat composition, repeated silhouettes, or generic UI.
21
+ - 2: Premium stylized. Authored silhouettes, material/detail systems, readable state, cohesive UI/world, measured performance.
22
+ - 3: Showcase. Strong art direction, memorable hero and world, dense authored detail, excellent readability, polished VFX/rendering, and diagnostics.
23
+
24
+ ## Categories
25
+
26
+ 1. Art direction.
27
+ - 0: No clear theme.
28
+ - 1: Theme is mostly colors/fog.
29
+ - 2: Theme affects forms, materials, UI, world, and feedback.
30
+ - 3: Distinct identity visible in every surface.
31
+ 2. Hero/player.
32
+ - 0: Default primitive stack.
33
+ - 1: Basic object with glow or simple attachments.
34
+ - 2: Authored silhouette, decals/trim, state cues, collision proxy.
35
+ - 3: Memorable model with layered construction and expressive feedback.
36
+ 3. Obstacles/enemies.
37
+ - 0: Cubes/cones/spheres.
38
+ - 1: Recolored repeated silhouette.
39
+ - 2: Three readable variants with telegraphs and material cues.
40
+ - 3: Varied family with animation, anticipation, and gameplay clarity.
41
+ 4. Rewards/interactables.
42
+ - 0: Plain sphere/ring/token.
43
+ - 1: Repeated object with simple glow.
44
+ - 2: Two authored forms with idle/collect states and UI feedback.
45
+ - 3: Desirable, animated, and clearly valued during motion.
46
+ 5. World/environment.
47
+ - 0: Flat plane, empty arena, box skyline.
48
+ - 1: Themed but sparse repeated blocks.
49
+ - 2: Layered prop kit with foreground/midground/background and scale cues.
50
+ - 3: Dense authored world that supports gameplay readability.
51
+ 6. Materials/textures.
52
+ - 0: Flat colors.
53
+ - 1: Basic roughness/metalness or emissive color.
54
+ - 2: Shared material roles, procedural decals, trim, panel lines, wear/noise.
55
+ - 3: Rich cohesive material language with measured texture/resource use.
56
+ 7. Lighting/render.
57
+ - 0: Default lights or unreadable darkness.
58
+ - 1: Fog/bloom used as main style.
59
+ - 2: Intentional tone mapping, exposure, key/fill/rim, contact, depth.
60
+ - 3: Cinematic but readable composition with disciplined post-processing.
61
+ 8. VFX/motion.
62
+ - 0: None or random particles.
63
+ - 1: Generic particles/trails.
64
+ - 2: Event-driven VFX for boost, pickup, hit, fail, combo, shield, or spawn.
65
+ - 3: High-impact effects that clarify gameplay and remain performant.
66
+ 9. UI/HUD.
67
+ - 0: Debug text or missing UI.
68
+ - 1: Generic stat-card dashboard.
69
+ - 2: Genre-specific HUD states, meters/icons, responsive text fit.
70
+ - 3: Cohesive game interface with strong hierarchy and polished transitions.
71
+ 10. Performance evidence.
72
+ - 0: No metrics after visual changes.
73
+ - 1: Informal "seems fine".
74
+ - 2: Renderer counts, build/browser QA, desktop/mobile screenshots, and technical-art budget notes.
75
+ - 3: Baseline/post metrics, bottleneck notes, budgets, optimized asset strategy, and VFX/readability tradeoffs.
76
+
77
+ ## Thresholds
78
+
79
+ Premium:
80
+
81
+ - Every category at least 2.
82
+ - Average at least 2.3.
83
+ - Desktop and mobile active-play screenshots captured when mobile is in scope.
84
+ - Renderer diagnostics reported after graphics changes.
85
+
86
+ Showcase:
87
+
88
+ - At least six categories score 3.
89
+ - No category below 2.
90
+ - Average at least 2.7.
91
+ - Performance evidence includes before/after or budget-aware notes.
92
+
93
+ ## Automatic Failures
94
+
95
+ Any of these prevents a premium/AAA/showcase claim:
96
+
97
+ - Active screenshot is primitive-dominant.
98
+ - Main world is mostly stretched boxes, flat planes, or a sparse arena.
99
+ - Hero asset is mostly default primitives plus glow.
100
+ - Obstacles or rewards are one repeated silhouette.
101
+ - HUD is mostly rectangular stat/debug cards.
102
+ - Fog, darkness, bloom, or particles hide missing authored geometry.
103
+ - UI overlaps the play path, clips text, or fails mobile safe areas.
104
+ - The game is not playable through real input.
105
+ - No active-play screenshot was captured.
106
+ - No renderer diagnostics were collected after major graphics work.
107
+ - No technical-art budget or imported/generated asset diagnostics were reported for premium graphics work.
108
+
109
+ ## Measured Evidence
110
+
111
+ Run the canvas inspector (`pnpm exec node` on `../game-test/scripts/inspect-threejs-canvas.mjs`, or a project `inspect:canvas` script) on desktop and mobile and cite its `metrics` and `renderBudget` blocks in the scorecard. The numbers are advisory signals, not gates, but they must be reported and low values must be explained rather than ignored:
112
+
113
+ - `colorEntropyBits` below ~3.0 or `dominantColorShare` above ~0.6 suggests a sparse, flat scene — supporting evidence against World/environment or Materials/textures scores above 2.
114
+ - `edgeDensity` below ~0.04 suggests primitive-dominant or empty framing — supporting evidence against World/environment and Hero/player scores above 2.
115
+ - `luminance.contrast` below ~60 suggests fog/darkness compression — supporting evidence against Lighting/render scores above 2.
116
+ - `renderBudget` rows over the tier budget require a documented tradeoff in the technical-art budget (see `technical-art.md`).
117
+ - Renderer diagnostics (calls, triangles, geometries, textures) back the Performance evidence category.
118
+
119
+ ## Fresh-Eyes Review
120
+
121
+ The builder must not be the only grader. For premium/AAA/showcase claims:
122
+
123
+ - If the runner supports subagents (Task tool or equivalent), spawn a reviewer with ONLY: the screenshots, this scorecard file, and the inspector metrics JSON. No build context, no prior scores. The reviewer must receive the COMPLETE capture set — every captured state, desktop and mobile — never a hand-picked subset; a curated selection can hide weak states or miss content the builder knows exists (capture states with the inspector's `--state` flag so nothing is gated behind live play). The reviewer fills the scorecard independently; reconcile by taking the lower score per category unless concrete evidence overturns it. Report both score sets.
124
+ - If subagents are unavailable, run an adversarial self-review before finalizing: for each category, write one sentence making the strongest case that the score is a 1, citing what is visible in the screenshot; only then assign the score. Include these sentences in the report.
125
+
126
+ ## Report Format
127
+
128
+ ```text
129
+ Visual scorecard:
130
+ - Art direction: before X / after Y - evidence:
131
+ - Hero/player: before X / after Y - evidence:
132
+ - Obstacles/enemies: before X / after Y - evidence:
133
+ - Rewards/interactables: before X / after Y - evidence:
134
+ - World/environment: before X / after Y - evidence:
135
+ - Materials/textures: before X / after Y - evidence:
136
+ - Lighting/render: before X / after Y - evidence:
137
+ - VFX/motion: before X / after Y - evidence:
138
+ - UI/HUD: before X / after Y - evidence:
139
+ - Performance evidence: before X / after Y - evidence:
140
+ Measured evidence: colorEntropyBits / edgeDensity / luminance.contrast /
141
+ dominantColorShare per viewport, renderer diagnostics, render budget rows
142
+ Fresh-eyes review: subagent scores or adversarial self-review notes
143
+ Average:
144
+ Automatic failures remaining:
145
+ ```
146
+
147
+ If any category remains below threshold, state the exact next pass instead of declaring completion.
@@ -0,0 +1,102 @@
1
+ """Optional UV surface baking on an isolated runtime copy, after source capture."""
2
+ import bpy
3
+ import hashlib
4
+
5
+
6
+ def bake_procedural_materials(scene, output, features, size, warnings):
7
+ original_engine = scene.render.engine
8
+ scene.render.engine = 'CYCLES'
9
+ scene.cycles.samples = 16
10
+ for obj in list(scene.objects):
11
+ if obj.type != 'MESH' or obj.hide_render or not obj.data.polygons:
12
+ continue
13
+ originals = [s.material for s in obj.material_slots]
14
+ if not any(m and features.get(m.name, {}).get('procedural') for m in originals):
15
+ continue
16
+ if any(m is None or features[m.name]['unsupported_nodes'] or features[m.name].get('unsupported_inputs') for m in originals):
17
+ warnings.append(obj.name + ':包含不支持的材质闭包,跳过自动表面烘焙。')
18
+ continue
19
+ # Bake each object's complete UV atlas so shared source materials do not
20
+ # accidentally pick up another object's coordinates or transforms.
21
+ obj.data = obj.data.copy()
22
+ obj.data.materials.clear()
23
+ working = [mat.copy() for mat in originals]
24
+ for mat in working:
25
+ obj.data.materials.append(mat)
26
+ bpy.ops.object.select_all(action='DESELECT')
27
+ obj.hide_set(False)
28
+ obj.select_set(True)
29
+ bpy.context.view_layer.objects.active = obj
30
+ if not obj.data.uv_layers:
31
+ bpy.ops.object.mode_set(mode='EDIT')
32
+ bpy.ops.mesh.select_all(action='SELECT')
33
+ bpy.ops.uv.smart_project(island_margin=.03)
34
+ bpy.ops.object.mode_set(mode='OBJECT')
35
+ obj.data.uv_layers.active = obj.data.uv_layers[0]
36
+ obj.data.uv_layers[0].active_render = True
37
+ key = hashlib.sha256(obj.name.encode()).hexdigest()[:12]
38
+ baked = {}
39
+ supported = True
40
+ for mat in working:
41
+ if not mat.use_nodes:
42
+ mat.use_nodes = True
43
+ out = next((n for n in mat.node_tree.nodes if n.type == 'OUTPUT_MATERIAL' and n.is_active_output), None)
44
+ if not out or not out.inputs['Surface'].is_linked or out.inputs['Surface'].links[0].from_node.type != 'BSDF_PRINCIPLED':
45
+ supported = False
46
+ if not supported:
47
+ warnings.append(obj.name + ':自动烘焙要求输出直接连接 Principled BSDF。')
48
+ continue
49
+ for channel, socket_name in [('base_color','Base Color'), ('roughness','Roughness'), ('metallic','Metallic'), ('normal','Normal')]:
50
+ image = bpy.data.images.new('Stage bake '+key+' '+channel, width=size, height=size, alpha=False)
51
+ image.colorspace_settings.name = 'sRGB' if channel == 'base_color' else 'Non-Color'
52
+ restore = []
53
+ for mat in working:
54
+ nodes, links = mat.node_tree.nodes, mat.node_tree.links
55
+ out = next(n for n in nodes if n.type == 'OUTPUT_MATERIAL' and n.is_active_output)
56
+ shader = out.inputs['Surface'].links[0].from_node
57
+ target = nodes.new('ShaderNodeTexImage')
58
+ target.image = image
59
+ nodes.active = target
60
+ emitter = None
61
+ if channel != 'normal':
62
+ emitter = nodes.new('ShaderNodeEmission')
63
+ socket = shader.inputs[socket_name]
64
+ if socket.is_linked:
65
+ links.new(socket.links[0].from_socket, emitter.inputs['Color'])
66
+ else:
67
+ value = socket.default_value
68
+ emitter.inputs['Color'].default_value = tuple(value) if hasattr(value, '__len__') else (value,value,value,1)
69
+ links.new(emitter.outputs[0], out.inputs['Surface'])
70
+ restore.append((mat, out, shader, target, emitter))
71
+ try:
72
+ bpy.ops.object.bake(type='NORMAL' if channel == 'normal' else 'EMIT', normal_space='TANGENT', margin=12, use_clear=True)
73
+ file = f'textures/{key}_{channel}.png'
74
+ image.filepath_raw = str(output/file)
75
+ image.file_format = 'PNG'
76
+ image.save()
77
+ baked[channel] = (image, file)
78
+ finally:
79
+ for mat, out, shader, target, emitter in restore:
80
+ mat.node_tree.links.new(shader.outputs['BSDF'], out.inputs['Surface'])
81
+ mat.node_tree.nodes.remove(target)
82
+ if emitter:
83
+ mat.node_tree.nodes.remove(emitter)
84
+ for source, mat in zip(originals, working):
85
+ mat.name = source.name + '::' + key
86
+ nodes, links = mat.node_tree.nodes, mat.node_tree.links
87
+ out = next(n for n in nodes if n.type == 'OUTPUT_MATERIAL' and n.is_active_output)
88
+ shader = out.inputs['Surface'].links[0].from_node
89
+ for channel, socket in [('base_color','Base Color'), ('roughness','Roughness'), ('metallic','Metallic'), ('normal','Normal')]:
90
+ image, file = baked[channel]
91
+ texture = nodes.new('ShaderNodeTexImage')
92
+ texture.image = image
93
+ if channel == 'normal':
94
+ normal = nodes.new('ShaderNodeNormalMap')
95
+ links.new(texture.outputs['Color'], normal.inputs['Color'])
96
+ links.new(normal.outputs['Normal'], shader.inputs[socket])
97
+ else:
98
+ links.new(texture.outputs['Color'], shader.inputs[socket])
99
+ features[source.name]['baked_channels'][obj.name+':'+channel] = file
100
+ features[source.name]['baked_objects'] = features[source.name].get('baked_objects', []) + [obj.name]
101
+ features[source.name].setdefault('runtime_materials', []).append({'object': obj.name, 'material_name': mat.name})
102
+ scene.render.engine = original_engine