blenderwright 2.2.1__tar.gz → 3.0.0__tar.gz

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 (246) hide show
  1. {blenderwright-2.2.1 → blenderwright-3.0.0}/.github/workflows/release.yml +2 -2
  2. {blenderwright-2.2.1 → blenderwright-3.0.0}/PKG-INFO +27 -20
  3. {blenderwright-2.2.1 → blenderwright-3.0.0}/README.md +25 -19
  4. {blenderwright-2.2.1 → blenderwright-3.0.0}/addon/__init__.py +2 -2
  5. blenderwright-3.0.0/addon/auth.py +90 -0
  6. {blenderwright-2.2.1 → blenderwright-3.0.0}/addon/blender_manifest.toml +2 -2
  7. {blenderwright-2.2.1 → blenderwright-3.0.0}/addon/handlers/__init__.py +6 -0
  8. {blenderwright-2.2.1 → blenderwright-3.0.0}/addon/handlers/animation.py +10 -4
  9. {blenderwright-2.2.1 → blenderwright-3.0.0}/addon/handlers/armature.py +9 -21
  10. blenderwright-3.0.0/addon/handlers/baking.py +123 -0
  11. {blenderwright-2.2.1 → blenderwright-3.0.0}/addon/handlers/camera.py +37 -39
  12. {blenderwright-2.2.1 → blenderwright-3.0.0}/addon/handlers/collections.py +43 -0
  13. blenderwright-3.0.0/addon/handlers/compositor.py +233 -0
  14. blenderwright-3.0.0/addon/handlers/deform.py +288 -0
  15. {blenderwright-2.2.1 → blenderwright-3.0.0}/addon/handlers/file_ops.py +88 -11
  16. {blenderwright-2.2.1 → blenderwright-3.0.0}/addon/handlers/geometry_nodes.py +139 -12
  17. {blenderwright-2.2.1 → blenderwright-3.0.0}/addon/handlers/lighting.py +125 -41
  18. {blenderwright-2.2.1 → blenderwright-3.0.0}/addon/handlers/materials.py +12 -1
  19. {blenderwright-2.2.1 → blenderwright-3.0.0}/addon/handlers/mesh_editing.py +65 -0
  20. {blenderwright-2.2.1 → blenderwright-3.0.0}/addon/handlers/mesh_quality.py +6 -4
  21. {blenderwright-2.2.1 → blenderwright-3.0.0}/addon/handlers/physics.py +9 -5
  22. blenderwright-3.0.0/addon/handlers/rendering.py +458 -0
  23. {blenderwright-2.2.1 → blenderwright-3.0.0}/addon/handlers/sculpting.py +30 -22
  24. blenderwright-3.0.0/addon/handlers/uv.py +345 -0
  25. {blenderwright-2.2.1 → blenderwright-3.0.0}/addon/render_guard.py +5 -3
  26. blenderwright-3.0.0/addon/server.py +352 -0
  27. {blenderwright-2.2.1 → blenderwright-3.0.0}/addon/ui_panel.py +5 -0
  28. {blenderwright-2.2.1 → blenderwright-3.0.0}/docs/index.html +386 -41
  29. {blenderwright-2.2.1 → blenderwright-3.0.0}/pyproject.toml +7 -1
  30. {blenderwright-2.2.1 → blenderwright-3.0.0}/src/blenderwright/connection.py +182 -8
  31. {blenderwright-2.2.1 → blenderwright-3.0.0}/src/blenderwright/prompts/workflows.py +51 -0
  32. {blenderwright-2.2.1 → blenderwright-3.0.0}/src/blenderwright/server.py +4 -0
  33. blenderwright-3.0.0/src/blenderwright/tools/baking.py +95 -0
  34. {blenderwright-2.2.1 → blenderwright-3.0.0}/src/blenderwright/tools/collections.py +77 -1
  35. blenderwright-3.0.0/src/blenderwright/tools/compositor.py +126 -0
  36. blenderwright-3.0.0/src/blenderwright/tools/deform.py +351 -0
  37. {blenderwright-2.2.1 → blenderwright-3.0.0}/src/blenderwright/tools/file_ops.py +80 -7
  38. {blenderwright-2.2.1 → blenderwright-3.0.0}/src/blenderwright/tools/geometry_nodes.py +62 -1
  39. {blenderwright-2.2.1 → blenderwright-3.0.0}/src/blenderwright/tools/lighting.py +129 -8
  40. {blenderwright-2.2.1 → blenderwright-3.0.0}/src/blenderwright/tools/materials.py +8 -2
  41. {blenderwright-2.2.1 → blenderwright-3.0.0}/src/blenderwright/tools/mesh_editing.py +138 -0
  42. blenderwright-3.0.0/src/blenderwright/tools/render_settings.py +564 -0
  43. {blenderwright-2.2.1 → blenderwright-3.0.0}/src/blenderwright/tools/rendering.py +0 -1
  44. blenderwright-3.0.0/src/blenderwright/tools/uv.py +285 -0
  45. {blenderwright-2.2.1 → blenderwright-3.0.0}/src/blenderwright/toolsets.py +45 -20
  46. {blenderwright-2.2.1 → blenderwright-3.0.0}/src/blenderwright/validators.py +48 -2
  47. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/conftest.py +23 -0
  48. blenderwright-3.0.0/tests/test_addon/conftest.py +63 -0
  49. blenderwright-3.0.0/tests/test_addon/test_handlers/test_animation_handler.py +92 -0
  50. blenderwright-3.0.0/tests/test_addon/test_handlers/test_armature_handler.py +66 -0
  51. blenderwright-3.0.0/tests/test_addon/test_handlers/test_baking_handler.py +146 -0
  52. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_addon/test_handlers/test_camera_handler.py +94 -0
  53. blenderwright-3.0.0/tests/test_addon/test_handlers/test_collections_handler.py +92 -0
  54. blenderwright-3.0.0/tests/test_addon/test_handlers/test_compositor_handler.py +308 -0
  55. blenderwright-3.0.0/tests/test_addon/test_handlers/test_deform_handler.py +268 -0
  56. blenderwright-3.0.0/tests/test_addon/test_handlers/test_file_ops_handler.py +210 -0
  57. blenderwright-3.0.0/tests/test_addon/test_handlers/test_geometry_nodes_handler.py +275 -0
  58. blenderwright-3.0.0/tests/test_addon/test_handlers/test_lighting_handler.py +189 -0
  59. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_addon/test_handlers/test_materials_handler.py +31 -5
  60. blenderwright-3.0.0/tests/test_addon/test_handlers/test_mesh_editing_handler.py +93 -0
  61. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_addon/test_handlers/test_mesh_quality_handler.py +46 -0
  62. blenderwright-3.0.0/tests/test_addon/test_handlers/test_physics_handler.py +83 -0
  63. blenderwright-3.0.0/tests/test_addon/test_handlers/test_rendering_handler.py +395 -0
  64. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_addon/test_handlers/test_sculpting_handler.py +46 -0
  65. blenderwright-3.0.0/tests/test_addon/test_handlers/test_uv_handler.py +133 -0
  66. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_addon/test_render_guard.py +25 -0
  67. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_addon/test_server.py +53 -30
  68. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_addon/test_ui_panel.py +11 -0
  69. blenderwright-3.0.0/tests/test_auth_token.py +94 -0
  70. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_connection.py +16 -1
  71. blenderwright-3.0.0/tests/test_connection_auth.py +11 -0
  72. blenderwright-3.0.0/tests/test_handshake.py +302 -0
  73. blenderwright-3.0.0/tests/test_port_claim.py +44 -0
  74. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_project_metadata.py +13 -0
  75. blenderwright-3.0.0/tests/test_tools/test_baking.py +72 -0
  76. blenderwright-3.0.0/tests/test_tools/test_color_management.py +103 -0
  77. blenderwright-3.0.0/tests/test_tools/test_compositor.py +114 -0
  78. blenderwright-3.0.0/tests/test_tools/test_deform.py +153 -0
  79. blenderwright-3.0.0/tests/test_tools/test_essentials_modifiers.py +49 -0
  80. blenderwright-3.0.0/tests/test_tools/test_file_formats.py +23 -0
  81. blenderwright-3.0.0/tests/test_tools/test_imported_mesh_cleanup_prompt.py +71 -0
  82. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_tools/test_lighting.py +56 -1
  83. blenderwright-3.0.0/tests/test_tools/test_link_append.py +103 -0
  84. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_tools/test_new_nodes.py +9 -0
  85. blenderwright-3.0.0/tests/test_tools/test_render_quality.py +142 -0
  86. blenderwright-3.0.0/tests/test_tools/test_render_settings_2.py +105 -0
  87. blenderwright-3.0.0/tests/test_tools/test_symmetry_loop_tools.py +80 -0
  88. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_tools/test_uv.py +21 -0
  89. blenderwright-3.0.0/tests/test_tools/test_uv_islands.py +82 -0
  90. blenderwright-3.0.0/tests/test_tools/test_uv_unwrap_methods.py +25 -0
  91. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_toolsets.py +25 -1
  92. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_validators.py +55 -0
  93. {blenderwright-2.2.1 → blenderwright-3.0.0}/uv.lock +17 -4
  94. blenderwright-2.2.1/addon/handlers/rendering.py +0 -167
  95. blenderwright-2.2.1/addon/handlers/uv.py +0 -181
  96. blenderwright-2.2.1/addon/server.py +0 -228
  97. blenderwright-2.2.1/src/blenderwright/tools/uv.py +0 -133
  98. blenderwright-2.2.1/tests/test_addon/conftest.py +0 -28
  99. blenderwright-2.2.1/tests/test_addon/test_handlers/test_geometry_nodes_handler.py +0 -97
  100. blenderwright-2.2.1/tests/test_addon/test_handlers/test_rendering_handler.py +0 -145
  101. blenderwright-2.2.1/tests/test_tools/test_uv_slim.py +0 -23
  102. {blenderwright-2.2.1 → blenderwright-3.0.0}/.github/FUNDING.yml +0 -0
  103. {blenderwright-2.2.1 → blenderwright-3.0.0}/.github/workflows/ci.yml +0 -0
  104. {blenderwright-2.2.1 → blenderwright-3.0.0}/.github/workflows/pylint.yml +0 -0
  105. {blenderwright-2.2.1 → blenderwright-3.0.0}/.github/workflows/test-bpy51.yml +0 -0
  106. {blenderwright-2.2.1 → blenderwright-3.0.0}/.gitignore +0 -0
  107. {blenderwright-2.2.1 → blenderwright-3.0.0}/LICENSE.md +0 -0
  108. {blenderwright-2.2.1 → blenderwright-3.0.0}/addon/dispatcher.py +0 -0
  109. {blenderwright-2.2.1 → blenderwright-3.0.0}/addon/handlers/booltool.py +0 -0
  110. {blenderwright-2.2.1 → blenderwright-3.0.0}/addon/handlers/code_exec.py +0 -0
  111. {blenderwright-2.2.1 → blenderwright-3.0.0}/addon/handlers/curves.py +0 -0
  112. {blenderwright-2.2.1 → blenderwright-3.0.0}/addon/handlers/gpencil.py +0 -0
  113. {blenderwright-2.2.1 → blenderwright-3.0.0}/addon/handlers/modeling.py +0 -0
  114. {blenderwright-2.2.1 → blenderwright-3.0.0}/addon/handlers/objects.py +0 -0
  115. {blenderwright-2.2.1 → blenderwright-3.0.0}/addon/handlers/print3d.py +0 -0
  116. {blenderwright-2.2.1 → blenderwright-3.0.0}/addon/handlers/procedural.py +0 -0
  117. {blenderwright-2.2.1 → blenderwright-3.0.0}/addon/handlers/raster.py +0 -0
  118. {blenderwright-2.2.1 → blenderwright-3.0.0}/addon/handlers/scene.py +0 -0
  119. {blenderwright-2.2.1 → blenderwright-3.0.0}/addon/handlers/selection.py +0 -0
  120. {blenderwright-2.2.1 → blenderwright-3.0.0}/addon/handlers/sequencer.py +0 -0
  121. {blenderwright-2.2.1 → blenderwright-3.0.0}/addon/handlers/sweep.py +0 -0
  122. {blenderwright-2.2.1 → blenderwright-3.0.0}/addon/handlers/transforms.py +0 -0
  123. {blenderwright-2.2.1 → blenderwright-3.0.0}/addon/handlers/viewport.py +0 -0
  124. {blenderwright-2.2.1 → blenderwright-3.0.0}/addon/thread_safety.py +0 -0
  125. {blenderwright-2.2.1 → blenderwright-3.0.0}/blend-ai-v1.0.0.zip +0 -0
  126. {blenderwright-2.2.1 → blenderwright-3.0.0}/build.ps1 +0 -0
  127. {blenderwright-2.2.1 → blenderwright-3.0.0}/build.sh +0 -0
  128. {blenderwright-2.2.1 → blenderwright-3.0.0}/docs/.nojekyll +0 -0
  129. {blenderwright-2.2.1 → blenderwright-3.0.0}/docs/CNAME +0 -0
  130. {blenderwright-2.2.1 → blenderwright-3.0.0}/docs/googled2f6c71abc2d6a7b.html +0 -0
  131. {blenderwright-2.2.1 → blenderwright-3.0.0}/docs/robots.txt +0 -0
  132. {blenderwright-2.2.1 → blenderwright-3.0.0}/docs/shuttle-launch.mp4 +0 -0
  133. {blenderwright-2.2.1 → blenderwright-3.0.0}/docs/sitemap.xml +0 -0
  134. {blenderwright-2.2.1 → blenderwright-3.0.0}/glama.json +0 -0
  135. {blenderwright-2.2.1 → blenderwright-3.0.0}/install-addon.sh +0 -0
  136. {blenderwright-2.2.1 → blenderwright-3.0.0}/install_addon.py +0 -0
  137. {blenderwright-2.2.1 → blenderwright-3.0.0}/launch_ollama.sh +0 -0
  138. {blenderwright-2.2.1 → blenderwright-3.0.0}/saloon.png +0 -0
  139. {blenderwright-2.2.1 → blenderwright-3.0.0}/screenshot.png +0 -0
  140. {blenderwright-2.2.1 → blenderwright-3.0.0}/scripts/generate_tool_docs.py +0 -0
  141. {blenderwright-2.2.1 → blenderwright-3.0.0}/shader-preview.png +0 -0
  142. {blenderwright-2.2.1 → blenderwright-3.0.0}/shuttle-launch.gif +0 -0
  143. {blenderwright-2.2.1 → blenderwright-3.0.0}/shuttle-launch.png +0 -0
  144. {blenderwright-2.2.1 → blenderwright-3.0.0}/src/blenderwright/__init__.py +0 -0
  145. {blenderwright-2.2.1 → blenderwright-3.0.0}/src/blenderwright/__main__.py +0 -0
  146. {blenderwright-2.2.1 → blenderwright-3.0.0}/src/blenderwright/aliases.py +0 -0
  147. {blenderwright-2.2.1 → blenderwright-3.0.0}/src/blenderwright/enum_hints.py +0 -0
  148. {blenderwright-2.2.1 → blenderwright-3.0.0}/src/blenderwright/ollama_chat.py +0 -0
  149. {blenderwright-2.2.1 → blenderwright-3.0.0}/src/blenderwright/prompts/__init__.py +0 -0
  150. {blenderwright-2.2.1 → blenderwright-3.0.0}/src/blenderwright/resources/__init__.py +0 -0
  151. {blenderwright-2.2.1 → blenderwright-3.0.0}/src/blenderwright/resources/scene_info.py +0 -0
  152. {blenderwright-2.2.1 → blenderwright-3.0.0}/src/blenderwright/strict.py +0 -0
  153. {blenderwright-2.2.1 → blenderwright-3.0.0}/src/blenderwright/tool_registry.py +0 -0
  154. {blenderwright-2.2.1 → blenderwright-3.0.0}/src/blenderwright/tools/__init__.py +0 -0
  155. {blenderwright-2.2.1 → blenderwright-3.0.0}/src/blenderwright/tools/animation.py +0 -0
  156. {blenderwright-2.2.1 → blenderwright-3.0.0}/src/blenderwright/tools/armature.py +0 -0
  157. {blenderwright-2.2.1 → blenderwright-3.0.0}/src/blenderwright/tools/booltool.py +0 -0
  158. {blenderwright-2.2.1 → blenderwright-3.0.0}/src/blenderwright/tools/camera.py +0 -0
  159. {blenderwright-2.2.1 → blenderwright-3.0.0}/src/blenderwright/tools/code_exec.py +0 -0
  160. {blenderwright-2.2.1 → blenderwright-3.0.0}/src/blenderwright/tools/curves.py +0 -0
  161. {blenderwright-2.2.1 → blenderwright-3.0.0}/src/blenderwright/tools/gpencil.py +0 -0
  162. {blenderwright-2.2.1 → blenderwright-3.0.0}/src/blenderwright/tools/mesh_quality.py +0 -0
  163. {blenderwright-2.2.1 → blenderwright-3.0.0}/src/blenderwright/tools/modeling.py +0 -0
  164. {blenderwright-2.2.1 → blenderwright-3.0.0}/src/blenderwright/tools/objects.py +0 -0
  165. {blenderwright-2.2.1 → blenderwright-3.0.0}/src/blenderwright/tools/physics.py +0 -0
  166. {blenderwright-2.2.1 → blenderwright-3.0.0}/src/blenderwright/tools/print3d.py +0 -0
  167. {blenderwright-2.2.1 → blenderwright-3.0.0}/src/blenderwright/tools/scene.py +0 -0
  168. {blenderwright-2.2.1 → blenderwright-3.0.0}/src/blenderwright/tools/screenshot.py +0 -0
  169. {blenderwright-2.2.1 → blenderwright-3.0.0}/src/blenderwright/tools/sculpting.py +0 -0
  170. {blenderwright-2.2.1 → blenderwright-3.0.0}/src/blenderwright/tools/selection.py +0 -0
  171. {blenderwright-2.2.1 → blenderwright-3.0.0}/src/blenderwright/tools/sequencer.py +0 -0
  172. {blenderwright-2.2.1 → blenderwright-3.0.0}/src/blenderwright/tools/sweep.py +0 -0
  173. {blenderwright-2.2.1 → blenderwright-3.0.0}/src/blenderwright/tools/transforms.py +0 -0
  174. {blenderwright-2.2.1 → blenderwright-3.0.0}/src/blenderwright/tools/viewport.py +0 -0
  175. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/__init__.py +0 -0
  176. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_addon/__init__.py +0 -0
  177. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_addon/test_dispatcher.py +0 -0
  178. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_addon/test_handler_registration.py +0 -0
  179. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_addon/test_handlers/__init__.py +0 -0
  180. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_addon/test_handlers/test_code_exec_handler.py +0 -0
  181. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_addon/test_handlers/test_gpencil_handler.py +0 -0
  182. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_addon/test_handlers/test_modeling_handler.py +0 -0
  183. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_addon/test_handlers/test_objects_handler.py +0 -0
  184. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_addon/test_handlers/test_print3d_handler.py +0 -0
  185. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_addon/test_handlers/test_procedural_handler.py +0 -0
  186. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_addon/test_handlers/test_raster_handler.py +0 -0
  187. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_addon/test_handlers/test_scene_handler.py +0 -0
  188. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_addon/test_handlers/test_selection_handler.py +0 -0
  189. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_addon/test_handlers/test_sequencer_handler.py +0 -0
  190. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_addon/test_handlers/test_sweep_handler.py +0 -0
  191. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_addon/test_layer_consistency.py +0 -0
  192. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_addon/test_module_cache_purge.py +0 -0
  193. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_addon/test_thread_safety.py +0 -0
  194. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_command_registry.py +0 -0
  195. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_enum_hints.py +0 -0
  196. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_installer.py +0 -0
  197. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_long_names.py +0 -0
  198. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_object_param_naming.py +0 -0
  199. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_ollama_budget.py +0 -0
  200. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_ollama_chat.py +0 -0
  201. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_ollama_toolsets.py +0 -0
  202. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_ollama_vision.py +0 -0
  203. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_round_wasters.py +0 -0
  204. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_strict_parameters.py +0 -0
  205. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_tool_disambiguation.py +0 -0
  206. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_tools/__init__.py +0 -0
  207. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_tools/conftest.py +0 -0
  208. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_tools/test_animation.py +0 -0
  209. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_tools/test_armature.py +0 -0
  210. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_tools/test_auto_critique_prompt.py +0 -0
  211. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_tools/test_booltool.py +0 -0
  212. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_tools/test_camera.py +0 -0
  213. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_tools/test_code_exec.py +0 -0
  214. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_tools/test_collections.py +0 -0
  215. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_tools/test_curves.py +0 -0
  216. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_tools/test_eevee_light_path.py +0 -0
  217. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_tools/test_extensions.py +0 -0
  218. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_tools/test_file_ops.py +0 -0
  219. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_tools/test_geometry_nodes.py +0 -0
  220. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_tools/test_gpencil.py +0 -0
  221. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_tools/test_issue_31_validation.py +0 -0
  222. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_tools/test_materials.py +0 -0
  223. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_tools/test_mesh_editing.py +0 -0
  224. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_tools/test_mesh_quality.py +0 -0
  225. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_tools/test_mesh_repair.py +0 -0
  226. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_tools/test_modeling.py +0 -0
  227. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_tools/test_negative_scale_primitives.py +0 -0
  228. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_tools/test_numeric_text_values.py +0 -0
  229. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_tools/test_objects.py +0 -0
  230. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_tools/test_physics.py +0 -0
  231. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_tools/test_point_camera_at.py +0 -0
  232. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_tools/test_print3d.py +0 -0
  233. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_tools/test_procedural.py +0 -0
  234. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_tools/test_prompts.py +0 -0
  235. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_tools/test_raster.py +0 -0
  236. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_tools/test_rendering.py +0 -0
  237. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_tools/test_scene.py +0 -0
  238. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_tools/test_screenshot.py +0 -0
  239. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_tools/test_sculpting.py +0 -0
  240. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_tools/test_selection.py +0 -0
  241. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_tools/test_selection_respected.py +0 -0
  242. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_tools/test_sequencer.py +0 -0
  243. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_tools/test_shader_nodes.py +0 -0
  244. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_tools/test_sweep.py +0 -0
  245. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_tools/test_transforms.py +0 -0
  246. {blenderwright-2.2.1 → blenderwright-3.0.0}/tests/test_tools/test_viewport.py +0 -0
@@ -15,10 +15,10 @@ jobs:
15
15
  steps:
16
16
  - uses: actions/checkout@v4
17
17
 
18
- - name: Download Blender 4.2 LTS
18
+ - name: Download Blender 5.2 LTS
19
19
  run: |
20
20
  curl -sSfL -o blender.tar.xz \
21
- https://download.blender.org/release/Blender4.2/blender-4.2.0-linux-x64.tar.xz
21
+ https://download.blender.org/release/Blender5.2/blender-5.2.3-linux-x64.tar.xz
22
22
  mkdir -p blender
23
23
  tar -xf blender.tar.xz -C blender --strip-components=1
24
24
  echo "$PWD/blender" >> "$GITHUB_PATH"
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: blenderwright
3
- Version: 2.2.1
3
+ Version: 3.0.0
4
4
  Summary: The most intuitive and efficient MCP Server for Blender
5
5
  License-Expression: MIT
6
6
  License-File: LICENSE.md
@@ -10,6 +10,7 @@ Requires-Dist: pydantic>=2.0
10
10
  Provides-Extra: chat
11
11
  Requires-Dist: ollama>=0.4; extra == 'chat'
12
12
  Provides-Extra: dev
13
+ Requires-Dist: fake-bpy-module-5-2>=20260730; extra == 'dev'
13
14
  Requires-Dist: pytest-asyncio>=0.21; extra == 'dev'
14
15
  Requires-Dist: pytest-cov>=4.0; extra == 'dev'
15
16
  Requires-Dist: pytest>=7.0; extra == 'dev'
@@ -44,14 +45,14 @@ The most intuitive and efficient MCP Server for Blender. Control Blender entirel
44
45
 
45
46
  ## Key Features
46
47
 
47
- - **[191 tools](https://blenderwright.holdmybeer.gg/)** across 28 modules covering every major Blender domain: modeling, mesh editing, materials, shader nodes, lighting, camera, animation, rendering, sculpting, UV mapping, physics, geometry nodes, rigging, curves, sweeps along a path, 3D-print checking, annotations, collections, file I/O, Bool Tool, viewport control, mesh quality analysis, and extension suggestions
48
- - **12 expert prompts**: topology best practices, real-world scale references, lighting principles, studio setup, character basemesh workflow, PBR material guide, auto-critique feedback loop, and more
48
+ - **[230 tools](https://blenderwright.holdmybeer.gg/)** across 32 modules covering every major Blender domain: modeling, mesh editing, materials, shader nodes, lighting, camera, animation, rendering, sculpting, UV mapping, physics, geometry nodes, rigging, curves, sweeps along a path, 3D-print checking, annotations, collections, file I/O, Bool Tool, viewport control, mesh quality analysis, and extension suggestions
49
+ - **13 expert prompts**: topology best practices, real-world scale references, lighting principles, studio setup, character basemesh workflow, PBR material guide, auto-critique feedback loop, and more
49
50
  - **Visual feedback loop**: fast viewport screenshots via OpenGL render (~ms, not seconds) with auto-critique prompts that guide the LLM to check its own work
50
51
  - **Mesh quality analysis**: structured reports covering non-manifold edges, loose vertices, zero-area faces, duplicate vertices, and wire edges
51
52
  - **Extension suggestions**: proactively recommends Bool Tool, LoopTools, and Node Wrangler when a task would benefit from them (skips already-installed extensions)
52
53
  - **Raw Python is opt-in**: `execute_blender_code` is off until you tick "Allow raw Python" in the N-panel, per session, never saved into the .blend. When on, every snippet is echoed to the console and listed in the panel. A restricted namespace blocks obvious mistakes (`os`, `subprocess`, `exec`, `open`, ...); it is a guard against accidents, not a security boundary
53
54
  - **Render-aware**: automatically detects when Blender is rendering and queues commands. Recovers from stuck render guards via `load_post` handler and reset command
54
- - **Blender 4.2+ compatible**: ships as a Blender Extension; tested against Blender 5.1 with EEVEE identifier, Annotation API, sculpt stroke_method, SLIM UV unwrap, Raycast shader node, and EEVEE light path intensity controls
55
+ - **Built for Blender 5.2 LTS**: ships as a Blender Extension; developed and tested on Blender 5.2
55
56
  - **Custom port**: configure the server port from the N-panel UI (default: 9876, range: 1024–65535)
56
57
  - **Zero telemetry**: no usage tracking, no analytics, no data collection. Everything runs locally on `127.0.0.1`
57
58
  - **Zero-dependency addon**: the Blender addon uses only Python stdlib + `bpy`. Nothing to pip install inside Blender
@@ -80,17 +81,17 @@ Then point your client at `uv run --directory /path/to/blenderwright blenderwrig
80
81
  ### 2. Install the Blender addon
81
82
 
82
83
  1. Download the latest addon zip from [GitHub Releases](https://github.com/HoldMyBeer-gg/blenderwright/releases)
83
- 2. Open Blender 4.2 or later
84
+ 2. Open Blender 5.2 LTS
84
85
  3. Go to **Edit > Preferences > Get Extensions**, click the dropdown (▾) top-right, and choose **Install from Disk...**
85
86
  4. Select the downloaded `.zip` file
86
87
  5. Enable **"blenderwright"** in the extensions list
87
88
 
88
- > **Blender 4.0 / 4.1 users:** Not supported. blenderwright ships as a Blender Extension, which requires Blender 4.2 (LTS) or later. Please upgrade Blender from [blender.org/download](https://www.blender.org/download/).
89
+ > **Blender 5.1 and earlier:** Not supported. blenderwright targets Blender 5.2 LTS, and Blender refuses to install it on older versions. Please upgrade Blender from [blender.org/download](https://www.blender.org/download/).
89
90
 
90
91
  <details>
91
92
  <summary><strong>Developer install (symlink)</strong></summary>
92
93
 
93
- If you're developing on blenderwright, symlink the addon folder into Blender's user extensions directory instead. Replace `<ver>` with your Blender version (e.g. `4.2`, `5.1`).
94
+ If you're developing on blenderwright, symlink the addon folder into Blender's user extensions directory instead. Replace `<ver>` with your Blender version (e.g. `5.2`).
94
95
 
95
96
  ```bash
96
97
  # macOS
@@ -197,7 +198,7 @@ python install_addon.py upgrade /Applications/Blender.app/Contents/MacOS/Blender
197
198
  python install_addon.py upgrade /usr/local/bin/blender
198
199
 
199
200
  # Windows
200
- python install_addon.py upgrade "C:\Program Files\Blender Foundation\Blender 4.2\blender.exe"
201
+ python install_addon.py upgrade "C:\Program Files\Blender Foundation\Blender 5.2\blender.exe"
201
202
  ```
202
203
 
203
204
  It refuses to run while Blender is open, checks the path before touching anything,
@@ -236,7 +237,7 @@ you have; it reports symlinks distinctly.
236
237
 
237
238
  ## Expert Guidance
238
239
 
239
- blenderwright includes 12 MCP prompts that guide the LLM toward professional-quality results:
240
+ blenderwright includes 13 MCP prompts that guide the LLM toward professional-quality results:
240
241
 
241
242
  | Prompt | What It Teaches |
242
243
  |--------|----------------|
@@ -252,11 +253,12 @@ blenderwright includes 12 MCP prompts that guide the LLM toward professional-qua
252
253
  | `character_base_mesh` | Character modeling guide |
253
254
  | `scene_cleanup` | Scene organization workflow |
254
255
  | `animation_turntable` | Turntable animation setup |
256
+ | `imported_mesh_cleanup` | Import, analyze, repair, decimate, normals, scale, UVs for meshes from scans, downloads, or generators |
255
257
 
256
258
  ## Tool Domains
257
259
 
258
260
  <details>
259
- <summary><strong>All 191 tools across 28 modules</strong></summary>
261
+ <summary><strong>All 230 tools across 32 modules</strong></summary>
260
262
 
261
263
  Full reference with every parameter: **[blenderwright.holdmybeer.gg](https://blenderwright.holdmybeer.gg/)**
262
264
 
@@ -266,27 +268,31 @@ Full reference with every parameter: **[blenderwright.holdmybeer.gg](https://ble
266
268
  | Objects | 15 | Create primitives, duplicate, parent, join, visibility, origin, convert, auto-smooth |
267
269
  | Transforms | 6 | Position, rotation (euler/quat), scale, apply, snap |
268
270
  | Modeling | 13 | Modifiers, booleans, subdivide, extrude, bevel, loop cut, bridge edge loops |
269
- | Mesh Editing | 16 | Inset, fill, grid fill, mark seam/sharp, normals, dissolve, knife project, spin, crease |
271
+ | Mesh Editing | 19 | Inset, fill, grid fill, mark seam/sharp, normals, dissolve, knife project, spin, crease, symmetrize, bisect, loop tools (circle, space evenly, flatten) |
270
272
  | Selection | 6 | Select by index, by axis, by face sides, by similarity; invert; report what is selected |
271
273
  | Mesh Quality | 3 | Analyze mesh defects: non-manifold, loose verts, zero-area faces, duplicates and repair them; decimate to reduce polycount |
272
274
  | Bool Tool | 4 | Auto union, difference, intersect, slice (via Blender's Bool Tool addon) |
273
275
  | Materials | 25 | Principled BSDF, procedural and raster textures, textures, blend modes, shader node graph (add/connect/remove nodes, including 5.1 Raycast node) |
274
- | Lighting | 7 | Point/sun/spot/area lights, HDRIs, light rigs, shadows |
276
+ | Lighting | 9 | Point/sun/spot/area lights, HDRIs, light rigs, shadows, Blender's built-in HDRIs, HDRI rotation, procedural sky with sun, light linking |
275
277
  | Camera | 6 | Create, aim, DOF, viewport capture, active camera |
276
278
  | Animation | 8 | Keyframes, interpolation, frame range, follow path |
277
279
  | Rendering | 7 | Engine, resolution, samples, output format, render, EEVEE light path intensity |
280
+ | Render settings | 10 | Color management (AgX, looks, exposure), film transparency, denoising, Cycles sampling and light paths, motion blur, render passes, ray visibility and shadow catcher, EEVEE quality, render performance |
281
+ | Baking | 1 | Bake albedo, normal (high-poly to low-poly with cage), AO, roughness, emission or lit maps to PNG/EXR/TIFF with Cycles |
282
+ | Compositor | 5 | Post-processing chain: glare and bloom, lens distortion, colour balance, blur, Essentials vignette, film grain, chromatic aberration, split toning, sharpening |
283
+ | Deform | 10 | Vertex groups and weights (assign, normalize, smooth, clean, limit, mirror), shape keys (add, sculpt by offset with weighted falloff, blend, animate) |
278
284
  | Curves | 10 | Bezier/NURBS/path, 3D text, convert, reverse, handle types, cyclic, subdivide |
279
285
  | Sweep | 2 | Sweep a profile along a 3D path for tubes, hoses, cables and rails, with flip-free framing; check a path for bends too tight for the profile |
280
286
  | 3D Printing | 1 | Reversed normals, self-intersection, thin walls, shells and overhangs via Blender's 3D Print Toolbox |
281
287
  | Sequencer | 5 | Image-sequence strips, sound strips, list and remove strips, render to MP4, MKV or WebM with audio |
282
288
  | Sculpting | 8 | Brushes, remesh, multires, symmetry, dynamic topology, stroke_method |
283
- | UV Mapping | 4 | Smart project, unwrap (ANGLE_BASED, CONFORMAL, SLIM), projection, pack islands |
289
+ | UV Mapping | 7 | Smart project, unwrap (ANGLE_BASED, CONFORMAL, MINIMUM_STRETCH), projection, pack islands, island operations (average scale, minimize stretch, randomize, arrange, weld), texel density |
284
290
  | Physics | 9 | Rigid body, cloth, fluid, particles (velocity, rendering, delete), bake |
285
- | Geometry Nodes | 5 | Create node trees, add/connect nodes, set inputs |
291
+ | Geometry Nodes | 6 | Create node trees, add/connect nodes, set inputs, Essentials modifiers (array, scatter on surface, instance on elements, curve to tube, ...) |
286
292
  | Armature | 6 | Bones, constraints, auto weights, pose |
287
293
  | Annotations | 5 | Annotation layers and strokes (5.1 Annotation API) |
288
- | Collections | 4 | Create, move objects, visibility, delete |
289
- | File I/O | 5 | Import/export (FBX, OBJ, glTF, USD, STL...), save/open |
294
+ | Collections | 6 | Create, move objects, visibility, delete, collection instances, make instances real |
295
+ | File I/O | 7 | Import/export (FBX, OBJ, glTF, USD, STL...), save/open, list/link/append from other .blend files |
290
296
  | Viewport | 3 | Shading mode, overlays, focus on object |
291
297
  | Screenshot | 1 | Fast viewport capture (OpenGL) or full render, base64 output |
292
298
  | Code Exec | 1 | Sandboxed Python execution in Blender (dangerous imports blocked) |
@@ -330,7 +336,7 @@ AI Assistant <--stdio/MCP--> blenderwright server <--TCP socket--> Blender addon
330
336
  - **MCP Server** (`src/blenderwright/`): Python process using the `mcp` SDK. Exposes tools, resources, and prompts over stdio. Validates all inputs before forwarding to Blender.
331
337
  - **Blender Addon** (`addon/`): Runs a TCP socket server inside Blender on a background thread. Commands are queued and executed on the main thread via `bpy.app.timers` to respect Blender's threading model.
332
338
  - **Render Guard**: Tracks render state via `bpy.app.handlers`. During renders, the server immediately returns a "busy" status. Automatically recovers from crashed renders via `load_post` handler. Can be force-reset via MCP command.
333
- - **Protocol**: Length-prefixed JSON messages over TCP with SO_KEEPALIVE for stale connection detection. Each message is a 4-byte big-endian length header followed by a UTF-8 JSON payload.
339
+ - **Protocol**: Length-prefixed JSON messages over TCP with SO_KEEPALIVE for stale connection detection. Each message is a 4-byte big-endian length header followed by a UTF-8 JSON payload. A connection opens with a challenge-response handshake that also checks both sides speak the same protocol version, then every message is signed (see Security).
334
340
 
335
341
  </details>
336
342
 
@@ -349,6 +355,7 @@ AI Assistant <--stdio/MCP--> blenderwright server <--TCP socket--> Blender addon
349
355
  <summary><strong>Security</strong></summary>
350
356
 
351
357
  - **Localhost only**: The TCP socket binds to `127.0.0.1`, never exposed to the network.
358
+ - **Authenticated socket**: any local program can reach `127.0.0.1`, so the connection is authenticated. Start Server writes a fresh random token to a file only your user can read (`~/Library/Application Support/blenderwright/token` on macOS, `%APPDATA%\blenderwright\token` on Windows, `~/.config/blenderwright/token` on Linux) and deletes it on Stop. The token never crosses the socket: Blender and the MCP server each prove they know it by signing fresh random nonces (HMAC-SHA256), and every command and reply after that is signed with a per-connection key and numbered, so commands cannot be injected, altered or replayed. The MCP server refuses to send anything to a process on the port that cannot prove itself. A failed check closes the connection and the N-panel shows the count. On Windows the port is claimed exclusively. If the MCP server runs where it can't see the token file (WSL, Docker), set `BLENDERWRIGHT_TOKEN_FILE` to its path.
352
359
  - **Raw Python is off by default**: `execute_blender_code` refuses to run until you tick "Allow raw Python" in the blenderwright N-panel. The switch is a `WindowManager` property, so it is per Blender session and is never written into a `.blend` file. Every run is echoed to the system console and the panel shows a count and the last snippet. The 191 structured tools do not need it.
353
360
  - **The restricted namespace is not a sandbox**: when raw Python is on, the import hook refuses 25 imports (`os`, `subprocess`, `socket`, `shutil`, `sys`, `ctypes`, `importlib`, `pathlib`, `signal`, `multiprocessing`, `pickle`, `shelve`, `tempfile`, `http`, `urllib`, `ftplib`, `smtplib`, `xmlrpc`, `code`, `codeop`, `compileall`, `webbrowser`, `antigravity`, `turtle`, `tkinter`) and the builtins `__import__`, `exec`, `eval`, `compile`, `open`, `globals`, `locals`, `vars`, `input`, `breakpoint`, `exit`, `quit`, `help` and `memoryview` are removed. That catches a model making a mistake. It does not contain an adversary: the code runs in-process with full `bpy`, and `bpy` alone can save files anywhere and run any operator. Treat "Allow raw Python" the way you would treat running a script someone else wrote: read what the model is about to run, and turn it off when you are done.
354
361
  - **Input validation**: All inputs pass through validators before reaching Blender: name sanitization, path traversal prevention, numeric range checks, enum allowlists.
@@ -402,11 +409,11 @@ blenderwright/
402
409
  │ ├── server.py # FastMCP entry point
403
410
  │ ├── connection.py # TCP client to Blender (with busy-retry)
404
411
  │ ├── validators.py # Input validation
405
- │ ├── tools/ # 28 tool modules (191 tools)
412
+ │ ├── tools/ # 32 tool modules (230 tools)
406
413
  │ ├── resources/ # MCP resources (scene, objects, materials)
407
- │ └── prompts/ # 12 expert prompt templates
414
+ │ └── prompts/ # 13 expert prompt templates
408
415
  ├── addon/ # Blender addon (zero external deps)
409
- │ ├── blender_manifest.toml # Blender 4.2+ Extension manifest
416
+ │ ├── blender_manifest.toml # Blender 5.2+ Extension manifest
410
417
  │ ├── __init__.py # bl_info (legacy fallback) + register/unregister
411
418
  │ ├── server.py # TCP socket server (SO_KEEPALIVE)
412
419
  │ ├── dispatcher.py # Command routing + allowlist
@@ -26,14 +26,14 @@ The most intuitive and efficient MCP Server for Blender. Control Blender entirel
26
26
 
27
27
  ## Key Features
28
28
 
29
- - **[191 tools](https://blenderwright.holdmybeer.gg/)** across 28 modules covering every major Blender domain: modeling, mesh editing, materials, shader nodes, lighting, camera, animation, rendering, sculpting, UV mapping, physics, geometry nodes, rigging, curves, sweeps along a path, 3D-print checking, annotations, collections, file I/O, Bool Tool, viewport control, mesh quality analysis, and extension suggestions
30
- - **12 expert prompts**: topology best practices, real-world scale references, lighting principles, studio setup, character basemesh workflow, PBR material guide, auto-critique feedback loop, and more
29
+ - **[230 tools](https://blenderwright.holdmybeer.gg/)** across 32 modules covering every major Blender domain: modeling, mesh editing, materials, shader nodes, lighting, camera, animation, rendering, sculpting, UV mapping, physics, geometry nodes, rigging, curves, sweeps along a path, 3D-print checking, annotations, collections, file I/O, Bool Tool, viewport control, mesh quality analysis, and extension suggestions
30
+ - **13 expert prompts**: topology best practices, real-world scale references, lighting principles, studio setup, character basemesh workflow, PBR material guide, auto-critique feedback loop, and more
31
31
  - **Visual feedback loop**: fast viewport screenshots via OpenGL render (~ms, not seconds) with auto-critique prompts that guide the LLM to check its own work
32
32
  - **Mesh quality analysis**: structured reports covering non-manifold edges, loose vertices, zero-area faces, duplicate vertices, and wire edges
33
33
  - **Extension suggestions**: proactively recommends Bool Tool, LoopTools, and Node Wrangler when a task would benefit from them (skips already-installed extensions)
34
34
  - **Raw Python is opt-in**: `execute_blender_code` is off until you tick "Allow raw Python" in the N-panel, per session, never saved into the .blend. When on, every snippet is echoed to the console and listed in the panel. A restricted namespace blocks obvious mistakes (`os`, `subprocess`, `exec`, `open`, ...); it is a guard against accidents, not a security boundary
35
35
  - **Render-aware**: automatically detects when Blender is rendering and queues commands. Recovers from stuck render guards via `load_post` handler and reset command
36
- - **Blender 4.2+ compatible**: ships as a Blender Extension; tested against Blender 5.1 with EEVEE identifier, Annotation API, sculpt stroke_method, SLIM UV unwrap, Raycast shader node, and EEVEE light path intensity controls
36
+ - **Built for Blender 5.2 LTS**: ships as a Blender Extension; developed and tested on Blender 5.2
37
37
  - **Custom port**: configure the server port from the N-panel UI (default: 9876, range: 1024–65535)
38
38
  - **Zero telemetry**: no usage tracking, no analytics, no data collection. Everything runs locally on `127.0.0.1`
39
39
  - **Zero-dependency addon**: the Blender addon uses only Python stdlib + `bpy`. Nothing to pip install inside Blender
@@ -62,17 +62,17 @@ Then point your client at `uv run --directory /path/to/blenderwright blenderwrig
62
62
  ### 2. Install the Blender addon
63
63
 
64
64
  1. Download the latest addon zip from [GitHub Releases](https://github.com/HoldMyBeer-gg/blenderwright/releases)
65
- 2. Open Blender 4.2 or later
65
+ 2. Open Blender 5.2 LTS
66
66
  3. Go to **Edit > Preferences > Get Extensions**, click the dropdown (▾) top-right, and choose **Install from Disk...**
67
67
  4. Select the downloaded `.zip` file
68
68
  5. Enable **"blenderwright"** in the extensions list
69
69
 
70
- > **Blender 4.0 / 4.1 users:** Not supported. blenderwright ships as a Blender Extension, which requires Blender 4.2 (LTS) or later. Please upgrade Blender from [blender.org/download](https://www.blender.org/download/).
70
+ > **Blender 5.1 and earlier:** Not supported. blenderwright targets Blender 5.2 LTS, and Blender refuses to install it on older versions. Please upgrade Blender from [blender.org/download](https://www.blender.org/download/).
71
71
 
72
72
  <details>
73
73
  <summary><strong>Developer install (symlink)</strong></summary>
74
74
 
75
- If you're developing on blenderwright, symlink the addon folder into Blender's user extensions directory instead. Replace `<ver>` with your Blender version (e.g. `4.2`, `5.1`).
75
+ If you're developing on blenderwright, symlink the addon folder into Blender's user extensions directory instead. Replace `<ver>` with your Blender version (e.g. `5.2`).
76
76
 
77
77
  ```bash
78
78
  # macOS
@@ -179,7 +179,7 @@ python install_addon.py upgrade /Applications/Blender.app/Contents/MacOS/Blender
179
179
  python install_addon.py upgrade /usr/local/bin/blender
180
180
 
181
181
  # Windows
182
- python install_addon.py upgrade "C:\Program Files\Blender Foundation\Blender 4.2\blender.exe"
182
+ python install_addon.py upgrade "C:\Program Files\Blender Foundation\Blender 5.2\blender.exe"
183
183
  ```
184
184
 
185
185
  It refuses to run while Blender is open, checks the path before touching anything,
@@ -218,7 +218,7 @@ you have; it reports symlinks distinctly.
218
218
 
219
219
  ## Expert Guidance
220
220
 
221
- blenderwright includes 12 MCP prompts that guide the LLM toward professional-quality results:
221
+ blenderwright includes 13 MCP prompts that guide the LLM toward professional-quality results:
222
222
 
223
223
  | Prompt | What It Teaches |
224
224
  |--------|----------------|
@@ -234,11 +234,12 @@ blenderwright includes 12 MCP prompts that guide the LLM toward professional-qua
234
234
  | `character_base_mesh` | Character modeling guide |
235
235
  | `scene_cleanup` | Scene organization workflow |
236
236
  | `animation_turntable` | Turntable animation setup |
237
+ | `imported_mesh_cleanup` | Import, analyze, repair, decimate, normals, scale, UVs for meshes from scans, downloads, or generators |
237
238
 
238
239
  ## Tool Domains
239
240
 
240
241
  <details>
241
- <summary><strong>All 191 tools across 28 modules</strong></summary>
242
+ <summary><strong>All 230 tools across 32 modules</strong></summary>
242
243
 
243
244
  Full reference with every parameter: **[blenderwright.holdmybeer.gg](https://blenderwright.holdmybeer.gg/)**
244
245
 
@@ -248,27 +249,31 @@ Full reference with every parameter: **[blenderwright.holdmybeer.gg](https://ble
248
249
  | Objects | 15 | Create primitives, duplicate, parent, join, visibility, origin, convert, auto-smooth |
249
250
  | Transforms | 6 | Position, rotation (euler/quat), scale, apply, snap |
250
251
  | Modeling | 13 | Modifiers, booleans, subdivide, extrude, bevel, loop cut, bridge edge loops |
251
- | Mesh Editing | 16 | Inset, fill, grid fill, mark seam/sharp, normals, dissolve, knife project, spin, crease |
252
+ | Mesh Editing | 19 | Inset, fill, grid fill, mark seam/sharp, normals, dissolve, knife project, spin, crease, symmetrize, bisect, loop tools (circle, space evenly, flatten) |
252
253
  | Selection | 6 | Select by index, by axis, by face sides, by similarity; invert; report what is selected |
253
254
  | Mesh Quality | 3 | Analyze mesh defects: non-manifold, loose verts, zero-area faces, duplicates and repair them; decimate to reduce polycount |
254
255
  | Bool Tool | 4 | Auto union, difference, intersect, slice (via Blender's Bool Tool addon) |
255
256
  | Materials | 25 | Principled BSDF, procedural and raster textures, textures, blend modes, shader node graph (add/connect/remove nodes, including 5.1 Raycast node) |
256
- | Lighting | 7 | Point/sun/spot/area lights, HDRIs, light rigs, shadows |
257
+ | Lighting | 9 | Point/sun/spot/area lights, HDRIs, light rigs, shadows, Blender's built-in HDRIs, HDRI rotation, procedural sky with sun, light linking |
257
258
  | Camera | 6 | Create, aim, DOF, viewport capture, active camera |
258
259
  | Animation | 8 | Keyframes, interpolation, frame range, follow path |
259
260
  | Rendering | 7 | Engine, resolution, samples, output format, render, EEVEE light path intensity |
261
+ | Render settings | 10 | Color management (AgX, looks, exposure), film transparency, denoising, Cycles sampling and light paths, motion blur, render passes, ray visibility and shadow catcher, EEVEE quality, render performance |
262
+ | Baking | 1 | Bake albedo, normal (high-poly to low-poly with cage), AO, roughness, emission or lit maps to PNG/EXR/TIFF with Cycles |
263
+ | Compositor | 5 | Post-processing chain: glare and bloom, lens distortion, colour balance, blur, Essentials vignette, film grain, chromatic aberration, split toning, sharpening |
264
+ | Deform | 10 | Vertex groups and weights (assign, normalize, smooth, clean, limit, mirror), shape keys (add, sculpt by offset with weighted falloff, blend, animate) |
260
265
  | Curves | 10 | Bezier/NURBS/path, 3D text, convert, reverse, handle types, cyclic, subdivide |
261
266
  | Sweep | 2 | Sweep a profile along a 3D path for tubes, hoses, cables and rails, with flip-free framing; check a path for bends too tight for the profile |
262
267
  | 3D Printing | 1 | Reversed normals, self-intersection, thin walls, shells and overhangs via Blender's 3D Print Toolbox |
263
268
  | Sequencer | 5 | Image-sequence strips, sound strips, list and remove strips, render to MP4, MKV or WebM with audio |
264
269
  | Sculpting | 8 | Brushes, remesh, multires, symmetry, dynamic topology, stroke_method |
265
- | UV Mapping | 4 | Smart project, unwrap (ANGLE_BASED, CONFORMAL, SLIM), projection, pack islands |
270
+ | UV Mapping | 7 | Smart project, unwrap (ANGLE_BASED, CONFORMAL, MINIMUM_STRETCH), projection, pack islands, island operations (average scale, minimize stretch, randomize, arrange, weld), texel density |
266
271
  | Physics | 9 | Rigid body, cloth, fluid, particles (velocity, rendering, delete), bake |
267
- | Geometry Nodes | 5 | Create node trees, add/connect nodes, set inputs |
272
+ | Geometry Nodes | 6 | Create node trees, add/connect nodes, set inputs, Essentials modifiers (array, scatter on surface, instance on elements, curve to tube, ...) |
268
273
  | Armature | 6 | Bones, constraints, auto weights, pose |
269
274
  | Annotations | 5 | Annotation layers and strokes (5.1 Annotation API) |
270
- | Collections | 4 | Create, move objects, visibility, delete |
271
- | File I/O | 5 | Import/export (FBX, OBJ, glTF, USD, STL...), save/open |
275
+ | Collections | 6 | Create, move objects, visibility, delete, collection instances, make instances real |
276
+ | File I/O | 7 | Import/export (FBX, OBJ, glTF, USD, STL...), save/open, list/link/append from other .blend files |
272
277
  | Viewport | 3 | Shading mode, overlays, focus on object |
273
278
  | Screenshot | 1 | Fast viewport capture (OpenGL) or full render, base64 output |
274
279
  | Code Exec | 1 | Sandboxed Python execution in Blender (dangerous imports blocked) |
@@ -312,7 +317,7 @@ AI Assistant <--stdio/MCP--> blenderwright server <--TCP socket--> Blender addon
312
317
  - **MCP Server** (`src/blenderwright/`): Python process using the `mcp` SDK. Exposes tools, resources, and prompts over stdio. Validates all inputs before forwarding to Blender.
313
318
  - **Blender Addon** (`addon/`): Runs a TCP socket server inside Blender on a background thread. Commands are queued and executed on the main thread via `bpy.app.timers` to respect Blender's threading model.
314
319
  - **Render Guard**: Tracks render state via `bpy.app.handlers`. During renders, the server immediately returns a "busy" status. Automatically recovers from crashed renders via `load_post` handler. Can be force-reset via MCP command.
315
- - **Protocol**: Length-prefixed JSON messages over TCP with SO_KEEPALIVE for stale connection detection. Each message is a 4-byte big-endian length header followed by a UTF-8 JSON payload.
320
+ - **Protocol**: Length-prefixed JSON messages over TCP with SO_KEEPALIVE for stale connection detection. Each message is a 4-byte big-endian length header followed by a UTF-8 JSON payload. A connection opens with a challenge-response handshake that also checks both sides speak the same protocol version, then every message is signed (see Security).
316
321
 
317
322
  </details>
318
323
 
@@ -331,6 +336,7 @@ AI Assistant <--stdio/MCP--> blenderwright server <--TCP socket--> Blender addon
331
336
  <summary><strong>Security</strong></summary>
332
337
 
333
338
  - **Localhost only**: The TCP socket binds to `127.0.0.1`, never exposed to the network.
339
+ - **Authenticated socket**: any local program can reach `127.0.0.1`, so the connection is authenticated. Start Server writes a fresh random token to a file only your user can read (`~/Library/Application Support/blenderwright/token` on macOS, `%APPDATA%\blenderwright\token` on Windows, `~/.config/blenderwright/token` on Linux) and deletes it on Stop. The token never crosses the socket: Blender and the MCP server each prove they know it by signing fresh random nonces (HMAC-SHA256), and every command and reply after that is signed with a per-connection key and numbered, so commands cannot be injected, altered or replayed. The MCP server refuses to send anything to a process on the port that cannot prove itself. A failed check closes the connection and the N-panel shows the count. On Windows the port is claimed exclusively. If the MCP server runs where it can't see the token file (WSL, Docker), set `BLENDERWRIGHT_TOKEN_FILE` to its path.
334
340
  - **Raw Python is off by default**: `execute_blender_code` refuses to run until you tick "Allow raw Python" in the blenderwright N-panel. The switch is a `WindowManager` property, so it is per Blender session and is never written into a `.blend` file. Every run is echoed to the system console and the panel shows a count and the last snippet. The 191 structured tools do not need it.
335
341
  - **The restricted namespace is not a sandbox**: when raw Python is on, the import hook refuses 25 imports (`os`, `subprocess`, `socket`, `shutil`, `sys`, `ctypes`, `importlib`, `pathlib`, `signal`, `multiprocessing`, `pickle`, `shelve`, `tempfile`, `http`, `urllib`, `ftplib`, `smtplib`, `xmlrpc`, `code`, `codeop`, `compileall`, `webbrowser`, `antigravity`, `turtle`, `tkinter`) and the builtins `__import__`, `exec`, `eval`, `compile`, `open`, `globals`, `locals`, `vars`, `input`, `breakpoint`, `exit`, `quit`, `help` and `memoryview` are removed. That catches a model making a mistake. It does not contain an adversary: the code runs in-process with full `bpy`, and `bpy` alone can save files anywhere and run any operator. Treat "Allow raw Python" the way you would treat running a script someone else wrote: read what the model is about to run, and turn it off when you are done.
336
342
  - **Input validation**: All inputs pass through validators before reaching Blender: name sanitization, path traversal prevention, numeric range checks, enum allowlists.
@@ -384,11 +390,11 @@ blenderwright/
384
390
  │ ├── server.py # FastMCP entry point
385
391
  │ ├── connection.py # TCP client to Blender (with busy-retry)
386
392
  │ ├── validators.py # Input validation
387
- │ ├── tools/ # 28 tool modules (191 tools)
393
+ │ ├── tools/ # 32 tool modules (230 tools)
388
394
  │ ├── resources/ # MCP resources (scene, objects, materials)
389
- │ └── prompts/ # 12 expert prompt templates
395
+ │ └── prompts/ # 13 expert prompt templates
390
396
  ├── addon/ # Blender addon (zero external deps)
391
- │ ├── blender_manifest.toml # Blender 4.2+ Extension manifest
397
+ │ ├── blender_manifest.toml # Blender 5.2+ Extension manifest
392
398
  │ ├── __init__.py # bl_info (legacy fallback) + register/unregister
393
399
  │ ├── server.py # TCP socket server (SO_KEEPALIVE)
394
400
  │ ├── dispatcher.py # Command routing + allowlist
@@ -8,8 +8,8 @@ Blender's Python API.
8
8
  bl_info = {
9
9
  "name": "blenderwright",
10
10
  "author": "blenderwright",
11
- "version": (2, 2, 1),
12
- "blender": (4, 2, 0),
11
+ "version": (3, 0, 0),
12
+ "blender": (5, 2, 0),
13
13
  "location": "View3D > Sidebar > blenderwright",
14
14
  "description": "MCP Server integration for AI-assisted 3D workflows",
15
15
  "category": "Interface",
@@ -0,0 +1,90 @@
1
+ """Auth for the addon's TCP socket.
2
+
3
+ Any local process can connect to 127.0.0.1, so the socket alone proves
4
+ nothing. On start the server writes a fresh random token to a file only this
5
+ user can read. The token itself never crosses the socket: each side proves it
6
+ knows it by signing fresh nonces, then signs every message with a session
7
+ key. The path and crypto are mirrored in src/blenderwright/connection.py and
8
+ tests keep the two in step.
9
+ """
10
+
11
+ import hashlib
12
+ import hmac
13
+ import json
14
+ import os
15
+ import secrets
16
+ import sys
17
+
18
+ ENV_TOKEN_FILE = "BLENDERWRIGHT_TOKEN_FILE"
19
+
20
+
21
+ def token_path() -> str:
22
+ """Where the token lives: the env override, else the user's config dir."""
23
+ override = os.environ.get(ENV_TOKEN_FILE)
24
+ if override:
25
+ return override
26
+ home = os.path.expanduser("~")
27
+ if sys.platform == "win32":
28
+ base = os.environ.get("APPDATA") or os.path.join(home, "AppData", "Roaming")
29
+ elif sys.platform == "darwin":
30
+ base = os.path.join(home, "Library", "Application Support")
31
+ else:
32
+ base = os.environ.get("XDG_CONFIG_HOME") or os.path.join(home, ".config")
33
+ return os.path.join(base, "blenderwright", "token")
34
+
35
+
36
+ def new_token() -> str:
37
+ return secrets.token_hex(32)
38
+
39
+
40
+ def write_token(token: str) -> None:
41
+ """Write the token readable by this user only, replacing any old file."""
42
+ path = token_path()
43
+ directory = os.path.dirname(path)
44
+ os.makedirs(directory, mode=0o700, exist_ok=True)
45
+ if sys.platform != "win32":
46
+ os.chmod(directory, 0o700)
47
+ # A fresh 0600 file swapped in, so an old file's looser mode never applies
48
+ tmp = f"{path}.{os.getpid()}.tmp"
49
+ fd = os.open(tmp, os.O_WRONLY | os.O_CREAT | os.O_TRUNC, 0o600)
50
+ try:
51
+ with os.fdopen(fd, "w", encoding="utf-8") as f:
52
+ f.write(token)
53
+ os.replace(tmp, path)
54
+ except BaseException:
55
+ try:
56
+ os.remove(tmp)
57
+ except OSError:
58
+ pass
59
+ raise
60
+
61
+
62
+ def clear_token() -> None:
63
+ try:
64
+ os.remove(token_path())
65
+ except FileNotFoundError:
66
+ pass
67
+
68
+
69
+ # Challenge-response handshake (protocol 2). Mirrored in
70
+ # src/blenderwright/connection.py; tests/test_handshake.py keeps them equal.
71
+ PROTOCOL_VERSION = 2
72
+
73
+
74
+ def proof(token: str, role: str, first_nonce: str, second_nonce: str) -> str:
75
+ """HMAC proving knowledge of the token, bound to both nonces and a role."""
76
+ message = f"blenderwright-{role}|{first_nonce}|{second_nonce}".encode("utf-8")
77
+ return hmac.new(token.encode("utf-8"), message, hashlib.sha256).hexdigest()
78
+
79
+
80
+ def session_key(token: str, client_nonce: str, server_nonce: str) -> bytes:
81
+ """Per-connection key for signing commands and replies."""
82
+ message = f"blenderwright-session|{client_nonce}|{server_nonce}".encode("utf-8")
83
+ return hmac.new(token.encode("utf-8"), message, hashlib.sha256).digest()
84
+
85
+
86
+ def message_mac(key: bytes, direction: str, seq: int, body: dict) -> str:
87
+ """Signature over one message body, its direction and its sequence number."""
88
+ canonical = json.dumps(body, sort_keys=True, separators=(",", ":"))
89
+ message = f"{direction}|{seq}|".encode("utf-8") + canonical.encode("utf-8")
90
+ return hmac.new(key, message, hashlib.sha256).hexdigest()
@@ -1,7 +1,7 @@
1
1
  schema_version = "1.0.0"
2
2
 
3
3
  id = "blenderwright"
4
- version = "2.2.1"
4
+ version = "3.0.0"
5
5
  name = "blenderwright"
6
6
  tagline = "MCP server integration for AI-assisted 3D workflows"
7
7
  maintainer = "jabberwock <88205+jabberwock@users.noreply.github.com>"
@@ -11,7 +11,7 @@ website = "https://github.com/HoldMyBeer-gg/blenderwright"
11
11
 
12
12
  tags = ["Pipeline", "Development"]
13
13
 
14
- blender_version_min = "4.2.0"
14
+ blender_version_min = "5.2.0"
15
15
 
16
16
  license = [
17
17
  "SPDX:MIT",
@@ -30,6 +30,9 @@ from . import (
30
30
  sweep,
31
31
  print3d,
32
32
  sequencer,
33
+ compositor,
34
+ deform,
35
+ baking,
33
36
  )
34
37
 
35
38
  _modules = [
@@ -62,6 +65,9 @@ _modules = [
62
65
  sweep,
63
66
  print3d,
64
67
  sequencer,
68
+ compositor,
69
+ deform,
70
+ baking,
65
71
  ]
66
72
 
67
73
 
@@ -1,6 +1,7 @@
1
1
  """Blender handlers for animation operations."""
2
2
 
3
3
  import bpy
4
+ from bpy_extras import anim_utils
4
5
  from .. import dispatcher
5
6
 
6
7
 
@@ -12,6 +13,13 @@ def _get_object(name):
12
13
  return obj
13
14
 
14
15
 
16
+ def _action_fcurves(obj):
17
+ """F-curves in the object's assigned action slot, or [] if it has none."""
18
+ adt = obj.animation_data
19
+ channelbag = anim_utils.action_get_channelbag_for_slot(adt.action, adt.action_slot)
20
+ return channelbag.fcurves if channelbag is not None else []
21
+
22
+
15
23
  def _parse_data_path(data_path):
16
24
  """Parse a data_path like 'location[0]' into (base_path, index).
17
25
 
@@ -114,10 +122,9 @@ def handle_set_interpolation(params):
114
122
  if obj.animation_data is None or obj.animation_data.action is None:
115
123
  raise ValueError(f"Object '{obj.name}' has no animation data")
116
124
 
117
- action = obj.animation_data.action
118
125
  changed = 0
119
126
 
120
- for fcurve in action.fcurves:
127
+ for fcurve in _action_fcurves(obj):
121
128
  if fcurve.data_path == base_path:
122
129
  if index is not None and fcurve.array_index != index:
123
130
  continue
@@ -167,10 +174,9 @@ def handle_list_keyframes(params):
167
174
  if obj.animation_data is None or obj.animation_data.action is None:
168
175
  return []
169
176
 
170
- action = obj.animation_data.action
171
177
  keyframes = []
172
178
 
173
- for fcurve in action.fcurves:
179
+ for fcurve in _action_fcurves(obj):
174
180
  data_path = fcurve.data_path
175
181
  array_index = fcurve.array_index
176
182
 
@@ -21,14 +21,6 @@ ALLOWED_BONE_PROPERTIES = {
21
21
  CONSTRAINT_TARGET_PROPERTIES = {"target", "pole_target"}
22
22
 
23
23
 
24
- def _ensure_mode(obj, mode):
25
- """Ensure the given object is in the specified mode."""
26
- if bpy.context.view_layer.objects.active != obj:
27
- bpy.context.view_layer.objects.active = obj
28
- if obj.mode != mode:
29
- bpy.ops.object.mode_set(mode=mode)
30
-
31
-
32
24
  def handle_create_armature(params: dict) -> dict:
33
25
  """Create a new armature object."""
34
26
  name = params.get("name", "Armature")
@@ -55,8 +47,8 @@ def handle_create_armature(params: dict) -> dict:
55
47
 
56
48
  def handle_add_bone(params: dict) -> dict:
57
49
  """Add a bone to an armature. Enters edit mode automatically."""
58
- armature_name = params.get("armature_name")
59
- bone_name = params.get("bone_name")
50
+ armature_name = params["armature_name"]
51
+ bone_name = params["bone_name"]
60
52
  head = params.get("head", [0, 0, 0])
61
53
  tail = params.get("tail", [0, 0, 1])
62
54
  parent_bone = params.get("parent_bone", "")
@@ -68,10 +60,6 @@ def handle_add_bone(params: dict) -> dict:
68
60
  if armature_obj.type != 'ARMATURE':
69
61
  raise ValueError(f"Object '{armature_name}' is not an armature")
70
62
 
71
- # Store previous mode and active object
72
- prev_active = bpy.context.view_layer.objects.active
73
- prev_mode = prev_active.mode if prev_active else 'OBJECT' # noqa: F841
74
-
75
63
  # Ensure we're in object mode first, then switch to edit mode
76
64
  if bpy.context.view_layer.objects.active and bpy.context.view_layer.objects.active.mode != 'OBJECT':
77
65
  bpy.ops.object.mode_set(mode='OBJECT')
@@ -121,8 +109,8 @@ def handle_add_bone(params: dict) -> dict:
121
109
 
122
110
  def handle_set_bone_property(params: dict) -> dict:
123
111
  """Set a property on a bone."""
124
- armature_name = params.get("armature_name")
125
- bone_name = params.get("bone_name")
112
+ armature_name = params["armature_name"]
113
+ bone_name = params["bone_name"]
126
114
  prop = params.get("property")
127
115
  value = params.get("value")
128
116
 
@@ -171,7 +159,7 @@ def handle_set_bone_property(params: dict) -> dict:
171
159
 
172
160
  def handle_add_constraint(params: dict) -> dict:
173
161
  """Add a constraint to an object or pose bone."""
174
- object_name = params.get("object_name")
162
+ object_name = params["object_name"]
175
163
  bone_name = params.get("bone_name", "")
176
164
  constraint_type = params.get("constraint_type")
177
165
  properties = params.get("properties", {})
@@ -221,8 +209,8 @@ def handle_add_constraint(params: dict) -> dict:
221
209
 
222
210
  def handle_parent_mesh_to_armature(params: dict) -> dict:
223
211
  """Parent a mesh to an armature with automatic weights or other methods."""
224
- mesh_name = params.get("mesh_name")
225
- armature_name = params.get("armature_name")
212
+ mesh_name = params["mesh_name"]
213
+ armature_name = params["armature_name"]
226
214
  parent_type = params.get("type", "ARMATURE_AUTO")
227
215
 
228
216
  try:
@@ -262,8 +250,8 @@ def handle_parent_mesh_to_armature(params: dict) -> dict:
262
250
 
263
251
  def handle_set_pose(params: dict) -> dict:
264
252
  """Set bone pose transforms."""
265
- armature_name = params.get("armature_name")
266
- bone_name = params.get("bone_name")
253
+ armature_name = params["armature_name"]
254
+ bone_name = params["bone_name"]
267
255
  location = params.get("location")
268
256
  rotation = params.get("rotation")
269
257
  scale = params.get("scale")