Skip to content

EL4CTEO/blender-skills / skills/blender-core

blender-core

Verified

Foundation for any Blender 5.2+ task an agent drives - running bpy via MCP (live) or headless CLI, context overrides, locale-safe node lookup, enum discovery, 5.x API changes, verification. Use first for any Blender, bpy, .blend or 3D-asset request; routes to the specialized blender-* skills.

FileKindSize
SKILL.mdskill md7.8 KB
references/api-changes-5x.mdmarkdown9.1 KB
references/bpy-patterns.mdmarkdown7.6 KB
scripts/_bpyx.pyscript4.4 KB
scripts/env_report.pyscript2.0 KB
scripts/run_in_blender.pyscript3.2 KB

references/api-changes-5x.md

View on GitHub
# bpy migration: 4.x → 5.3 (what LLM memory / old tutorials get wrong)

Each row was verified against Blender 5.2.3; the 5.3 section against 5.3.0. Format: **old → new** (version).

## Core / properties
| Old | New |
|---|---|
| `scene["cycles"]`, dict access to `bpy.props` values | attribute access only; ID-props and RNA props are separate (5.0) |
| `bpy.props` `get` without `set` for read-only | `options={'READ_ONLY'}`; `set` without `get` is an error (5.0) |
| `get_transform`/`set_transform` | new prop callbacks that keep default storage (5.0) |
| user site-packages auto-loaded | no longer loaded by default (5.1) |
| Python 3.11 | Python 3.13 (5.1) |
| — | `bpy.data.all_ids` iterates over every ID (5.2) |
| — | `gpu.init()` required for `gpu` in `--background` (5.2) |
| IDProperty nesting unlimited | capped at 1024 levels (5.2) |
| mathutils float64 buffers | float32 buffers; numpy views are non-contiguous (5.0) |

## Mesh / modeling
| Old | New |
|---|---|
| `mesh.use_auto_smooth`, `auto_smooth_angle` | removed (4.1). Use `bpy.ops.object.shade_smooth_by_angle(angle=…)` or the "Smooth by Angle" modifier asset (`shade_auto_smooth`) |
| `mesh.calc_normals_split()`, `loop.normal` | `mesh.corner_normals` (read-only), `mesh.normals_domain` (4.1) |
| custom normals need auto smooth | they work directly: `mesh.normals_split_custom_set(...)` (4.1) |
| face maps | removed. Use a boolean face attribute (4.0) |
| Boolean solver `FAST` | `FLOAT`. Solvers: `EXACT` (default), `FLOAT`, `MANIFOLD` (4.5+) (5.0) |
| per-UV-map selection, `BMLoopUV.select*` | shared `.uv_select_*` attributes; `bm.uv_select_flush()` etc. (5.0) |
| UV pin auto-creates attribute | use the `*_ensure()` functions (5.0) |
| `brush.sculpt_tool` | `brush.sculpt_brush_type` (5.0); brushes are assets (4.3) |
| `tool_settings.unified_paint_settings` | `tool_settings.sculpt.unified_paint_settings` (mode-specific) (5.0) |
| radial symmetry on tool settings | `mesh.radial_symmetry` (5.0) |
| `brush.use_airbrush/use_anchor/use_space/...` | `brush.stroke_method` enum (5.1) |
| `brush.use_automasking_*`, `automasking_*` | `brush.mesh_automasking_settings.*` (5.2) |

## Nodes
| Old | New |
|---|---|
| `ng.inputs.new()` / `ng.outputs.new()` | `ng.interface.new_socket(name, in_out='INPUT', socket_type='NodeSocketFloat')` (4.0) |
| `mod["Socket_2"] = 1.0`, `mod["Socket_2_use_attribute"]` | `mod.properties.inputs.Socket_2.value = 1.0`; `.type = "ATTRIBUTE"`; `.attribute_name` (5.2). Use `getattr(mod.properties.inputs, sock.identifier)` |
| Compare / Random Value socket identifiers | changed (5.2): look up by name, not identifier |
| `scene.node_tree`, `scene.use_nodes = True` | `scene.compositing_node_group = bpy.data.node_groups.new(n, "CompositorNodeTree")` (5.0) |
| `material.use_nodes = True` | deprecated (5.0). New materials already have Principled + Output. Same for `world.use_nodes` |
| File Output `base_path`, `file_slots`, `layer_slots` | `directory`, `file_name`, `file_output_items` (5.0) |
| `CompositorNodeGamma`, `...MixRGB`, etc. | shader-node equivalents (`ShaderNodeGamma`, `ShaderNodeMix`) (5.0) |
| Color node output "RGBA" | "Color" (5.0) |
| Principled `Subsurface`, `Specular`, `Transmission`, `Coat`/`Clearcoat`, `Sheen`, `Emission` | `Subsurface Weight`, `Specular IOR Level`, `Transmission Weight`, `Coat Weight`, `Sheen Weight`, `Emission Color` (4.0) |
| — | Principled `Thin Wall` input (5.2); `Diffuse Roughness`, `Thin Film Thickness/IOR` (4.2–4.3) |
| `SpaceNodeEditor.geometry_nodes_type` | `node_tree_sub_type` (5.0) |
| Point Density texture node | removed (5.0) |

## Materials / rendering
| Old | New |
|---|---|
| engine `BLENDER_EEVEE_NEXT` (4.2–4.5) | `BLENDER_EEVEE` (5.0) |
| `material.blend_method`, `shadow_method` | `material.surface_render_method` = `DITHERED` / `BLENDED`; `shadow_method` removed (4.2). Use `visible_shadow` on the object |
| `scene.eevee.use_gtao`, `gtao_distance` | removed; `view_layer.eevee.ambient_occlusion_distance` (5.0) |
| render pass names `DiffCol`, `Z`, ... | `Diffuse Color`, `Depth`, ... (5.0) |
| `image_settings.file_format = "FFMPEG"` alone | set `image_settings.media_type` (`IMAGE`/`MULTI_LAYER_IMAGE`/`VIDEO`) **before** `file_format` (5.0) |
| Filmic default | AgX default (4.0). Views: Standard, AgX, Khronos PBR Neutral, ACES 1.3/2.0, Filmic, ... |
| — | Cycles texture cache: `scene.render.use_texture_cache`, `use_auto_generate_texture_cache` (.tx) (5.2) |
| `bgl`, `Image.bindcode`, GLSL-source shaders | `gpu` module, `gpu.texture.from_image()` (5.0) |

## Animation / rigging
| Old | New |
|---|---|
| `action.fcurves`, `action.groups`, `action.id_root` | slotted/layered actions. `cb = anim_utils.action_ensure_channelbag_for_slot(action, slot)` → `cb.fcurves.new/ensure/find`, `cb.groups`; `slot.target_id_type` (removed in 5.0; slots since 4.4) |
| `fcurves.new(path, index, action_group)` | `cb.fcurves.new(path, index=0, group_name="")` |
| assigning `animation_data.action` was enough | also set/check `animation_data.action_slot` (auto-picked on assign if suitable) |
| `ANIM_OT_convert_legacy_action` | removed. All actions are layered (5.1) |
| `armature.layers`, `bone.layers`, bone groups | bone collections: `arm.collections.new("FK")`, `bcoll.assign(bone)`, `bone.color.palette`, `pose_bone.color` (4.0) |
| `bone.select`, `select_head/tail` | removed from Bone; use `pose_bone.select` / `edit_bone.select*` (5.0) |
| `context.space_data.action` | removed (5.0) |

## Add-ons / UI / misc
| Old | New |
|---|---|
| `bl_info` dict add-on | extension with `blender_manifest.toml` (4.2). Legacy add-ons still load |
| `UILayout.template_list(columns=)` | no effect (deprecated 5.1) |
| `UIList.layout_type = "GRID"` | removed (5.0) |
| `AssetHandle`, `context.active_file` (asset shelf) | `AssetRepresentation`, `context.asset` (5.0) |
| `GPencilStroke`, `scene.grease_pencil` (annotations) | `AnnotationStroke`, `scene.annotation` (5.0) |
| `GreasePencilv3`, `bpy.data.grease_pencils_v3` | `GreasePencil`, `bpy.data.grease_pencils` (5.0) |
| VSE `frame_final_start/end/duration` | `left_handle`, `right_handle`, `duration` (5.1; old names deprecated) |
| VSE uses `context.scene` | `context.sequencer_scene` (5.0) |
| USD export `export_textures`, `visible_objects_only` | removed (5.0) |
| `PreferencesFilePaths.active_asset_library` index == `asset_libraries` index | offset: list starts with "All Libraries", "Essentials" (5.2) |
| log output format | changed (5.0). Don't regex-parse the render progress |

## 5.3 changes (verified on 5.3.0)
| Old | New |
|---|---|
| one compositor tree per scene | effects stack `scene.compositor_effects` (`SceneCompositorEffect.node_group`, `enable_for_render`). `scene.compositing_node_group` still works: it gets/sets the **active** effect's group and creates one if none exists |
| GN Import PLY output `Mesh` | `Geometry` (point cloud for Gaussian-splat PLYs, mesh otherwise). New `GeometryNodeImportSPZ`, `bpy.ops.wm.spz_import` |
| — | `PointCloud.type` = `POINTS` / `GAUSSIAN_SPLAT` (attributes `scale`, `rotation`, `radiance:base`, `radiance:sh_N`) |
| glTF export `export_image_add_webp`, `export_image_webp_fallback` | `export_image_add_compressed_images` + `export_compressed_images_type` (`WEBP`/`KTX2`) + `export_compressed_images_fallback` |
| glTF export `at_collection_center` | `collection_center_mode` (`WORLD_ORIGIN`, `CENTER_MASS`, `OBJECT_POSITION`, `INSTANCE_OFFSET`) |
| VSE `overlap_mode` `EXPAND` | `RIPPLE` (`OVERWRITE`, `SHUFFLE` unchanged). Strips are no longer clamped to content by default (`preferences.edit.clamp_strips_by_default`) |
| VSE `sequencer.update_scene_frame_range` | deprecated: scene strips follow their scene's range |
| Rigify `pose.convert_rotation` | `bpy.ops.anim.rotation_mode_convert(mode=, bake=)`, or `ob/pose_bone.convert_rotation_mode(rotation_mode, bake=False)` |
| `con = constraints.new(type); con.name = n` | `constraints.new(type, name=n)` |
| LoopTools add-on | built in: `mesh.relax_edge_loops`, `mesh.curve_edge_loops_between_selected`, `mesh.fit_edge_loops_to_annotation`, `mesh.space_edge_loops_evenly` |
| — | `mesh.primitive_quad_sphere_add(segments=4, method="EVEN_AREA")` |
| Weight Paint defaults off | `tool_settings.use_auto_normalize`, `use_multipaint` and `mesh.use_mirror_vertex_groups` default **on**. Brush "Paint" → "Set Weight"; new default "Add Weight" |
| Grease Pencil frame duration | disabled; `insert_blank_frame(duration=)` is ignored |
| `bpy.data.all_ids` order | undocumented implementation detail; don't rely on it |
| — | `colorspace_settings.interop_id` (names still valid), `KDTree(n, dimensions=2)`, `UILayout.label_multiline()`, `window_manager.undo_stack`, `context.markers` / `selected_markers`, built-in `OpenEXR` and `opentimelineio` modules |
| — | Collection importers: `collection.importer` + `bpy.ops.collection.importer_add/importer_import` (USD only) |
| GPU backend OpenGL (Windows/Linux) | Vulkan by default. `gpu.capabilities.ray_query_support_get()` |
| Sky `sun_disc` only visible | the sun disc now also lights the scene (breaking look change). Keep `sun_disc=False` when a Sun lamp is the sun |

When something is missing: `dir(obj)`, `T.bl_rna.properties.keys()`, `T.bl_rna.functions.keys()`, or `op.get_rna_type().properties` show the truth faster than docs.
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall