blenderwright 2.3.0__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.
- {blenderwright-2.3.0 → blenderwright-3.0.0}/.github/workflows/release.yml +2 -2
- {blenderwright-2.3.0 → blenderwright-3.0.0}/PKG-INFO +23 -17
- {blenderwright-2.3.0 → blenderwright-3.0.0}/README.md +21 -16
- {blenderwright-2.3.0 → blenderwright-3.0.0}/addon/__init__.py +2 -2
- blenderwright-3.0.0/addon/auth.py +90 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/addon/blender_manifest.toml +2 -2
- {blenderwright-2.3.0 → blenderwright-3.0.0}/addon/handlers/__init__.py +6 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/addon/handlers/animation.py +10 -4
- {blenderwright-2.3.0 → blenderwright-3.0.0}/addon/handlers/armature.py +9 -21
- blenderwright-3.0.0/addon/handlers/baking.py +123 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/addon/handlers/camera.py +37 -39
- {blenderwright-2.3.0 → blenderwright-3.0.0}/addon/handlers/collections.py +43 -0
- blenderwright-3.0.0/addon/handlers/compositor.py +233 -0
- blenderwright-3.0.0/addon/handlers/deform.py +288 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/addon/handlers/file_ops.py +88 -11
- {blenderwright-2.3.0 → blenderwright-3.0.0}/addon/handlers/geometry_nodes.py +139 -12
- {blenderwright-2.3.0 → blenderwright-3.0.0}/addon/handlers/lighting.py +125 -41
- {blenderwright-2.3.0 → blenderwright-3.0.0}/addon/handlers/materials.py +12 -1
- {blenderwright-2.3.0 → blenderwright-3.0.0}/addon/handlers/mesh_editing.py +65 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/addon/handlers/physics.py +9 -5
- blenderwright-3.0.0/addon/handlers/rendering.py +458 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/addon/handlers/sculpting.py +30 -22
- blenderwright-3.0.0/addon/handlers/uv.py +345 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/addon/render_guard.py +5 -3
- blenderwright-3.0.0/addon/server.py +352 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/addon/ui_panel.py +5 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/docs/index.html +386 -41
- {blenderwright-2.3.0 → blenderwright-3.0.0}/pyproject.toml +7 -1
- {blenderwright-2.3.0 → blenderwright-3.0.0}/src/blenderwright/connection.py +182 -8
- {blenderwright-2.3.0 → blenderwright-3.0.0}/src/blenderwright/server.py +4 -0
- blenderwright-3.0.0/src/blenderwright/tools/baking.py +95 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/src/blenderwright/tools/collections.py +77 -1
- blenderwright-3.0.0/src/blenderwright/tools/compositor.py +126 -0
- blenderwright-3.0.0/src/blenderwright/tools/deform.py +351 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/src/blenderwright/tools/file_ops.py +80 -7
- {blenderwright-2.3.0 → blenderwright-3.0.0}/src/blenderwright/tools/geometry_nodes.py +62 -1
- {blenderwright-2.3.0 → blenderwright-3.0.0}/src/blenderwright/tools/lighting.py +129 -8
- {blenderwright-2.3.0 → blenderwright-3.0.0}/src/blenderwright/tools/materials.py +8 -2
- {blenderwright-2.3.0 → blenderwright-3.0.0}/src/blenderwright/tools/mesh_editing.py +138 -0
- blenderwright-3.0.0/src/blenderwright/tools/render_settings.py +564 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/src/blenderwright/tools/rendering.py +0 -1
- blenderwright-3.0.0/src/blenderwright/tools/uv.py +285 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/src/blenderwright/toolsets.py +45 -20
- {blenderwright-2.3.0 → blenderwright-3.0.0}/src/blenderwright/validators.py +48 -2
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/conftest.py +23 -0
- blenderwright-3.0.0/tests/test_addon/conftest.py +63 -0
- blenderwright-3.0.0/tests/test_addon/test_handlers/test_animation_handler.py +92 -0
- blenderwright-3.0.0/tests/test_addon/test_handlers/test_armature_handler.py +66 -0
- blenderwright-3.0.0/tests/test_addon/test_handlers/test_baking_handler.py +146 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_addon/test_handlers/test_camera_handler.py +94 -0
- blenderwright-3.0.0/tests/test_addon/test_handlers/test_collections_handler.py +92 -0
- blenderwright-3.0.0/tests/test_addon/test_handlers/test_compositor_handler.py +308 -0
- blenderwright-3.0.0/tests/test_addon/test_handlers/test_deform_handler.py +268 -0
- blenderwright-3.0.0/tests/test_addon/test_handlers/test_file_ops_handler.py +210 -0
- blenderwright-3.0.0/tests/test_addon/test_handlers/test_geometry_nodes_handler.py +275 -0
- blenderwright-3.0.0/tests/test_addon/test_handlers/test_lighting_handler.py +189 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_addon/test_handlers/test_materials_handler.py +31 -5
- blenderwright-3.0.0/tests/test_addon/test_handlers/test_mesh_editing_handler.py +93 -0
- blenderwright-3.0.0/tests/test_addon/test_handlers/test_physics_handler.py +83 -0
- blenderwright-3.0.0/tests/test_addon/test_handlers/test_rendering_handler.py +395 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_addon/test_handlers/test_sculpting_handler.py +46 -0
- blenderwright-3.0.0/tests/test_addon/test_handlers/test_uv_handler.py +133 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_addon/test_render_guard.py +25 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_addon/test_server.py +53 -30
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_addon/test_ui_panel.py +11 -0
- blenderwright-3.0.0/tests/test_auth_token.py +94 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_connection.py +16 -1
- blenderwright-3.0.0/tests/test_connection_auth.py +11 -0
- blenderwright-3.0.0/tests/test_handshake.py +302 -0
- blenderwright-3.0.0/tests/test_port_claim.py +44 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_project_metadata.py +13 -0
- blenderwright-3.0.0/tests/test_tools/test_baking.py +72 -0
- blenderwright-3.0.0/tests/test_tools/test_color_management.py +103 -0
- blenderwright-3.0.0/tests/test_tools/test_compositor.py +114 -0
- blenderwright-3.0.0/tests/test_tools/test_deform.py +153 -0
- blenderwright-3.0.0/tests/test_tools/test_essentials_modifiers.py +49 -0
- blenderwright-3.0.0/tests/test_tools/test_file_formats.py +23 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_tools/test_lighting.py +56 -1
- blenderwright-3.0.0/tests/test_tools/test_link_append.py +103 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_tools/test_new_nodes.py +9 -0
- blenderwright-3.0.0/tests/test_tools/test_render_quality.py +142 -0
- blenderwright-3.0.0/tests/test_tools/test_render_settings_2.py +105 -0
- blenderwright-3.0.0/tests/test_tools/test_symmetry_loop_tools.py +80 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_tools/test_uv.py +21 -0
- blenderwright-3.0.0/tests/test_tools/test_uv_islands.py +82 -0
- blenderwright-3.0.0/tests/test_tools/test_uv_unwrap_methods.py +25 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_toolsets.py +25 -1
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_validators.py +55 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/uv.lock +14 -1
- blenderwright-2.3.0/addon/handlers/rendering.py +0 -167
- blenderwright-2.3.0/addon/handlers/uv.py +0 -181
- blenderwright-2.3.0/addon/server.py +0 -228
- blenderwright-2.3.0/src/blenderwright/tools/uv.py +0 -133
- blenderwright-2.3.0/tests/test_addon/conftest.py +0 -28
- blenderwright-2.3.0/tests/test_addon/test_handlers/test_geometry_nodes_handler.py +0 -97
- blenderwright-2.3.0/tests/test_addon/test_handlers/test_rendering_handler.py +0 -145
- blenderwright-2.3.0/tests/test_tools/test_uv_slim.py +0 -23
- {blenderwright-2.3.0 → blenderwright-3.0.0}/.github/FUNDING.yml +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/.github/workflows/ci.yml +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/.github/workflows/pylint.yml +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/.github/workflows/test-bpy51.yml +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/.gitignore +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/LICENSE.md +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/addon/dispatcher.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/addon/handlers/booltool.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/addon/handlers/code_exec.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/addon/handlers/curves.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/addon/handlers/gpencil.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/addon/handlers/mesh_quality.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/addon/handlers/modeling.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/addon/handlers/objects.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/addon/handlers/print3d.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/addon/handlers/procedural.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/addon/handlers/raster.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/addon/handlers/scene.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/addon/handlers/selection.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/addon/handlers/sequencer.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/addon/handlers/sweep.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/addon/handlers/transforms.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/addon/handlers/viewport.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/addon/thread_safety.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/blend-ai-v1.0.0.zip +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/build.ps1 +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/build.sh +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/docs/.nojekyll +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/docs/CNAME +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/docs/googled2f6c71abc2d6a7b.html +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/docs/robots.txt +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/docs/shuttle-launch.mp4 +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/docs/sitemap.xml +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/glama.json +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/install-addon.sh +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/install_addon.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/launch_ollama.sh +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/saloon.png +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/screenshot.png +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/scripts/generate_tool_docs.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/shader-preview.png +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/shuttle-launch.gif +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/shuttle-launch.png +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/src/blenderwright/__init__.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/src/blenderwright/__main__.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/src/blenderwright/aliases.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/src/blenderwright/enum_hints.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/src/blenderwright/ollama_chat.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/src/blenderwright/prompts/__init__.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/src/blenderwright/prompts/workflows.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/src/blenderwright/resources/__init__.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/src/blenderwright/resources/scene_info.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/src/blenderwright/strict.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/src/blenderwright/tool_registry.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/src/blenderwright/tools/__init__.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/src/blenderwright/tools/animation.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/src/blenderwright/tools/armature.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/src/blenderwright/tools/booltool.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/src/blenderwright/tools/camera.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/src/blenderwright/tools/code_exec.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/src/blenderwright/tools/curves.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/src/blenderwright/tools/gpencil.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/src/blenderwright/tools/mesh_quality.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/src/blenderwright/tools/modeling.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/src/blenderwright/tools/objects.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/src/blenderwright/tools/physics.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/src/blenderwright/tools/print3d.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/src/blenderwright/tools/scene.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/src/blenderwright/tools/screenshot.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/src/blenderwright/tools/sculpting.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/src/blenderwright/tools/selection.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/src/blenderwright/tools/sequencer.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/src/blenderwright/tools/sweep.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/src/blenderwright/tools/transforms.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/src/blenderwright/tools/viewport.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/__init__.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_addon/__init__.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_addon/test_dispatcher.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_addon/test_handler_registration.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_addon/test_handlers/__init__.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_addon/test_handlers/test_code_exec_handler.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_addon/test_handlers/test_gpencil_handler.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_addon/test_handlers/test_mesh_quality_handler.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_addon/test_handlers/test_modeling_handler.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_addon/test_handlers/test_objects_handler.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_addon/test_handlers/test_print3d_handler.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_addon/test_handlers/test_procedural_handler.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_addon/test_handlers/test_raster_handler.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_addon/test_handlers/test_scene_handler.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_addon/test_handlers/test_selection_handler.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_addon/test_handlers/test_sequencer_handler.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_addon/test_handlers/test_sweep_handler.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_addon/test_layer_consistency.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_addon/test_module_cache_purge.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_addon/test_thread_safety.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_command_registry.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_enum_hints.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_installer.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_long_names.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_object_param_naming.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_ollama_budget.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_ollama_chat.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_ollama_toolsets.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_ollama_vision.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_round_wasters.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_strict_parameters.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_tool_disambiguation.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_tools/__init__.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_tools/conftest.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_tools/test_animation.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_tools/test_armature.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_tools/test_auto_critique_prompt.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_tools/test_booltool.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_tools/test_camera.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_tools/test_code_exec.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_tools/test_collections.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_tools/test_curves.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_tools/test_eevee_light_path.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_tools/test_extensions.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_tools/test_file_ops.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_tools/test_geometry_nodes.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_tools/test_gpencil.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_tools/test_imported_mesh_cleanup_prompt.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_tools/test_issue_31_validation.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_tools/test_materials.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_tools/test_mesh_editing.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_tools/test_mesh_quality.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_tools/test_mesh_repair.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_tools/test_modeling.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_tools/test_negative_scale_primitives.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_tools/test_numeric_text_values.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_tools/test_objects.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_tools/test_physics.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_tools/test_point_camera_at.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_tools/test_print3d.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_tools/test_procedural.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_tools/test_prompts.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_tools/test_raster.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_tools/test_rendering.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_tools/test_scene.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_tools/test_screenshot.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_tools/test_sculpting.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_tools/test_selection.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_tools/test_selection_respected.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_tools/test_sequencer.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_tools/test_shader_nodes.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_tools/test_sweep.py +0 -0
- {blenderwright-2.3.0 → blenderwright-3.0.0}/tests/test_tools/test_transforms.py +0 -0
- {blenderwright-2.3.0 → 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
|
|
18
|
+
- name: Download Blender 5.2 LTS
|
|
19
19
|
run: |
|
|
20
20
|
curl -sSfL -o blender.tar.xz \
|
|
21
|
-
https://download.blender.org/release/
|
|
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:
|
|
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
|
-
- **[
|
|
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
|
|
48
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
|
|
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
|
|
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
|
|
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. `
|
|
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
|
|
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,
|
|
@@ -257,7 +258,7 @@ blenderwright includes 13 MCP prompts that guide the LLM toward professional-qua
|
|
|
257
258
|
## Tool Domains
|
|
258
259
|
|
|
259
260
|
<details>
|
|
260
|
-
<summary><strong>All
|
|
261
|
+
<summary><strong>All 230 tools across 32 modules</strong></summary>
|
|
261
262
|
|
|
262
263
|
Full reference with every parameter: **[blenderwright.holdmybeer.gg](https://blenderwright.holdmybeer.gg/)**
|
|
263
264
|
|
|
@@ -267,27 +268,31 @@ Full reference with every parameter: **[blenderwright.holdmybeer.gg](https://ble
|
|
|
267
268
|
| Objects | 15 | Create primitives, duplicate, parent, join, visibility, origin, convert, auto-smooth |
|
|
268
269
|
| Transforms | 6 | Position, rotation (euler/quat), scale, apply, snap |
|
|
269
270
|
| Modeling | 13 | Modifiers, booleans, subdivide, extrude, bevel, loop cut, bridge edge loops |
|
|
270
|
-
| Mesh Editing |
|
|
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) |
|
|
271
272
|
| Selection | 6 | Select by index, by axis, by face sides, by similarity; invert; report what is selected |
|
|
272
273
|
| Mesh Quality | 3 | Analyze mesh defects: non-manifold, loose verts, zero-area faces, duplicates and repair them; decimate to reduce polycount |
|
|
273
274
|
| Bool Tool | 4 | Auto union, difference, intersect, slice (via Blender's Bool Tool addon) |
|
|
274
275
|
| Materials | 25 | Principled BSDF, procedural and raster textures, textures, blend modes, shader node graph (add/connect/remove nodes, including 5.1 Raycast node) |
|
|
275
|
-
| Lighting |
|
|
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 |
|
|
276
277
|
| Camera | 6 | Create, aim, DOF, viewport capture, active camera |
|
|
277
278
|
| Animation | 8 | Keyframes, interpolation, frame range, follow path |
|
|
278
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) |
|
|
279
284
|
| Curves | 10 | Bezier/NURBS/path, 3D text, convert, reverse, handle types, cyclic, subdivide |
|
|
280
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 |
|
|
281
286
|
| 3D Printing | 1 | Reversed normals, self-intersection, thin walls, shells and overhangs via Blender's 3D Print Toolbox |
|
|
282
287
|
| Sequencer | 5 | Image-sequence strips, sound strips, list and remove strips, render to MP4, MKV or WebM with audio |
|
|
283
288
|
| Sculpting | 8 | Brushes, remesh, multires, symmetry, dynamic topology, stroke_method |
|
|
284
|
-
| UV Mapping |
|
|
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 |
|
|
285
290
|
| Physics | 9 | Rigid body, cloth, fluid, particles (velocity, rendering, delete), bake |
|
|
286
|
-
| Geometry Nodes |
|
|
291
|
+
| Geometry Nodes | 6 | Create node trees, add/connect nodes, set inputs, Essentials modifiers (array, scatter on surface, instance on elements, curve to tube, ...) |
|
|
287
292
|
| Armature | 6 | Bones, constraints, auto weights, pose |
|
|
288
293
|
| Annotations | 5 | Annotation layers and strokes (5.1 Annotation API) |
|
|
289
|
-
| Collections |
|
|
290
|
-
| File I/O |
|
|
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 |
|
|
291
296
|
| Viewport | 3 | Shading mode, overlays, focus on object |
|
|
292
297
|
| Screenshot | 1 | Fast viewport capture (OpenGL) or full render, base64 output |
|
|
293
298
|
| Code Exec | 1 | Sandboxed Python execution in Blender (dangerous imports blocked) |
|
|
@@ -331,7 +336,7 @@ AI Assistant <--stdio/MCP--> blenderwright server <--TCP socket--> Blender addon
|
|
|
331
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.
|
|
332
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.
|
|
333
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.
|
|
334
|
-
- **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).
|
|
335
340
|
|
|
336
341
|
</details>
|
|
337
342
|
|
|
@@ -350,6 +355,7 @@ AI Assistant <--stdio/MCP--> blenderwright server <--TCP socket--> Blender addon
|
|
|
350
355
|
<summary><strong>Security</strong></summary>
|
|
351
356
|
|
|
352
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.
|
|
353
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.
|
|
354
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.
|
|
355
361
|
- **Input validation**: All inputs pass through validators before reaching Blender: name sanitization, path traversal prevention, numeric range checks, enum allowlists.
|
|
@@ -403,11 +409,11 @@ blenderwright/
|
|
|
403
409
|
│ ├── server.py # FastMCP entry point
|
|
404
410
|
│ ├── connection.py # TCP client to Blender (with busy-retry)
|
|
405
411
|
│ ├── validators.py # Input validation
|
|
406
|
-
│ ├── tools/ #
|
|
412
|
+
│ ├── tools/ # 32 tool modules (230 tools)
|
|
407
413
|
│ ├── resources/ # MCP resources (scene, objects, materials)
|
|
408
414
|
│ └── prompts/ # 13 expert prompt templates
|
|
409
415
|
├── addon/ # Blender addon (zero external deps)
|
|
410
|
-
│ ├── blender_manifest.toml # Blender
|
|
416
|
+
│ ├── blender_manifest.toml # Blender 5.2+ Extension manifest
|
|
411
417
|
│ ├── __init__.py # bl_info (legacy fallback) + register/unregister
|
|
412
418
|
│ ├── server.py # TCP socket server (SO_KEEPALIVE)
|
|
413
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
|
-
- **[
|
|
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
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
|
|
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
|
|
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
|
|
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. `
|
|
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
|
|
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,
|
|
@@ -239,7 +239,7 @@ blenderwright includes 13 MCP prompts that guide the LLM toward professional-qua
|
|
|
239
239
|
## Tool Domains
|
|
240
240
|
|
|
241
241
|
<details>
|
|
242
|
-
<summary><strong>All
|
|
242
|
+
<summary><strong>All 230 tools across 32 modules</strong></summary>
|
|
243
243
|
|
|
244
244
|
Full reference with every parameter: **[blenderwright.holdmybeer.gg](https://blenderwright.holdmybeer.gg/)**
|
|
245
245
|
|
|
@@ -249,27 +249,31 @@ Full reference with every parameter: **[blenderwright.holdmybeer.gg](https://ble
|
|
|
249
249
|
| Objects | 15 | Create primitives, duplicate, parent, join, visibility, origin, convert, auto-smooth |
|
|
250
250
|
| Transforms | 6 | Position, rotation (euler/quat), scale, apply, snap |
|
|
251
251
|
| Modeling | 13 | Modifiers, booleans, subdivide, extrude, bevel, loop cut, bridge edge loops |
|
|
252
|
-
| Mesh Editing |
|
|
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) |
|
|
253
253
|
| Selection | 6 | Select by index, by axis, by face sides, by similarity; invert; report what is selected |
|
|
254
254
|
| Mesh Quality | 3 | Analyze mesh defects: non-manifold, loose verts, zero-area faces, duplicates and repair them; decimate to reduce polycount |
|
|
255
255
|
| Bool Tool | 4 | Auto union, difference, intersect, slice (via Blender's Bool Tool addon) |
|
|
256
256
|
| Materials | 25 | Principled BSDF, procedural and raster textures, textures, blend modes, shader node graph (add/connect/remove nodes, including 5.1 Raycast node) |
|
|
257
|
-
| Lighting |
|
|
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 |
|
|
258
258
|
| Camera | 6 | Create, aim, DOF, viewport capture, active camera |
|
|
259
259
|
| Animation | 8 | Keyframes, interpolation, frame range, follow path |
|
|
260
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) |
|
|
261
265
|
| Curves | 10 | Bezier/NURBS/path, 3D text, convert, reverse, handle types, cyclic, subdivide |
|
|
262
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 |
|
|
263
267
|
| 3D Printing | 1 | Reversed normals, self-intersection, thin walls, shells and overhangs via Blender's 3D Print Toolbox |
|
|
264
268
|
| Sequencer | 5 | Image-sequence strips, sound strips, list and remove strips, render to MP4, MKV or WebM with audio |
|
|
265
269
|
| Sculpting | 8 | Brushes, remesh, multires, symmetry, dynamic topology, stroke_method |
|
|
266
|
-
| UV Mapping |
|
|
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 |
|
|
267
271
|
| Physics | 9 | Rigid body, cloth, fluid, particles (velocity, rendering, delete), bake |
|
|
268
|
-
| Geometry Nodes |
|
|
272
|
+
| Geometry Nodes | 6 | Create node trees, add/connect nodes, set inputs, Essentials modifiers (array, scatter on surface, instance on elements, curve to tube, ...) |
|
|
269
273
|
| Armature | 6 | Bones, constraints, auto weights, pose |
|
|
270
274
|
| Annotations | 5 | Annotation layers and strokes (5.1 Annotation API) |
|
|
271
|
-
| Collections |
|
|
272
|
-
| File I/O |
|
|
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 |
|
|
273
277
|
| Viewport | 3 | Shading mode, overlays, focus on object |
|
|
274
278
|
| Screenshot | 1 | Fast viewport capture (OpenGL) or full render, base64 output |
|
|
275
279
|
| Code Exec | 1 | Sandboxed Python execution in Blender (dangerous imports blocked) |
|
|
@@ -313,7 +317,7 @@ AI Assistant <--stdio/MCP--> blenderwright server <--TCP socket--> Blender addon
|
|
|
313
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.
|
|
314
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.
|
|
315
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.
|
|
316
|
-
- **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).
|
|
317
321
|
|
|
318
322
|
</details>
|
|
319
323
|
|
|
@@ -332,6 +336,7 @@ AI Assistant <--stdio/MCP--> blenderwright server <--TCP socket--> Blender addon
|
|
|
332
336
|
<summary><strong>Security</strong></summary>
|
|
333
337
|
|
|
334
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.
|
|
335
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.
|
|
336
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.
|
|
337
342
|
- **Input validation**: All inputs pass through validators before reaching Blender: name sanitization, path traversal prevention, numeric range checks, enum allowlists.
|
|
@@ -385,11 +390,11 @@ blenderwright/
|
|
|
385
390
|
│ ├── server.py # FastMCP entry point
|
|
386
391
|
│ ├── connection.py # TCP client to Blender (with busy-retry)
|
|
387
392
|
│ ├── validators.py # Input validation
|
|
388
|
-
│ ├── tools/ #
|
|
393
|
+
│ ├── tools/ # 32 tool modules (230 tools)
|
|
389
394
|
│ ├── resources/ # MCP resources (scene, objects, materials)
|
|
390
395
|
│ └── prompts/ # 13 expert prompt templates
|
|
391
396
|
├── addon/ # Blender addon (zero external deps)
|
|
392
|
-
│ ├── blender_manifest.toml # Blender
|
|
397
|
+
│ ├── blender_manifest.toml # Blender 5.2+ Extension manifest
|
|
393
398
|
│ ├── __init__.py # bl_info (legacy fallback) + register/unregister
|
|
394
399
|
│ ├── server.py # TCP socket server (SO_KEEPALIVE)
|
|
395
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": (
|
|
12
|
-
"blender": (
|
|
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 = "
|
|
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 = "
|
|
14
|
+
blender_version_min = "5.2.0"
|
|
15
15
|
|
|
16
16
|
license = [
|
|
17
17
|
"SPDX:MIT",
|
|
@@ -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
|
|
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
|
|
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
|
|
59
|
-
bone_name = params
|
|
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
|
|
125
|
-
bone_name = params
|
|
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
|
|
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
|
|
225
|
-
armature_name = params
|
|
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
|
|
266
|
-
bone_name = params
|
|
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")
|