skills.rest
OpenAEC-Foundation
OpenAEC-FoundationOFFICIAL
Explore all skills by this author →
GitHub

blender-syntax-properties

Define and manage Blender bpy.props types with PropertyGroup registration and version compatibility.

30|4|Updated Mar 5, 2026
Search Tags:#addon development#blender#python api#bpy.props#propertygroup#enumproperty#pointerproperty
One-click install
npx skills add https://github.com/OpenAEC-Foundation/Blender-Bonsai-ifcOpenshell-Sverchok-Claude-Skill-Package --skill blender-syntax-properties
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: blender-syntax-properties
Source: https://github.com/OpenAEC-Foundation/Blender-Bonsai-ifcOpenshell-Sverchok-Claude-Skill-Package/tree/main/skills/blender/syntax/blender-syntax-properties
Command: npx skills add https://github.com/OpenAEC-Foundation/Blender-Bonsai-ifcOpenshell-Sverchok-Claude-Skill-Package --skill blender-syntax-properties

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill addresses the complexities of defining and managing custom properties within Blender, ensuring correct registration, dynamic behavior, and version compatibility.

Core Features & Use Cases

  • Property Definition: Covers all bpy.props types (Bool, Int, Float, String, Enum, Vector, Pointer, Collection).
  • PropertyGroup Management: Handles registration, nesting, and dynamic item generation for enums.
  • Advanced Patterns: Demonstrates update callbacks, getters/setters, transform handlers (Blender 5.0+), and ENUM_FLAG usage.
  • Use Case: When creating a custom Blender addon that requires user-configurable settings, you'll use this Skill to define properties for UI elements like sliders, dropdowns, and toggles, ensuring they behave as expected and are saved correctly.

Quick Start

Use the blender-syntax-properties skill to define a new BoolProperty named 'is_active' with a default value of True.

Frequently Asked Questions about blender-syntax-properties

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I define a custom PropertyGroup in Blender addon development?▼

To define a custom PropertyGroup in Blender addon development, you register a Python class inheriting from PropertyGroup, populate it with bpy.props definitions, and register it with bpy.utils.register_class for UI integration.

What's the best way to create dynamic enum items in bpy.props?▼

Creating dynamic enum items in bpy.props is best achieved by assigning a callback function to the EnumProperty's items parameter, which evaluates runtime context and returns the active enumeration items list dynamically.

Does bpy.props support update callbacks for Blender 3.x, 4.x, and 5.x?▼

Yes, bpy.props supports update callbacks across Blender 3.x, 4.x, and 5.x, allowing you to execute custom Python logic whenever a property value changes, with version-specific handling for transform handlers in 5.x.

Why does my PointerProperty not save correctly in Blender?▼

Your PointerProperty might not save correctly in Blender if the target type is unregistered before file save, or if anti-patterns like circular referencing are used, preventing proper serialization of the property data.

Can I use getters and setters with FloatProperty in the Blender Python API?▼

Yes, you can use getters and setters with FloatProperty in the Blender Python API by passing custom functions to the get and set parameters, enabling controlled access and computed property values.

When do I need to use ENUM_FLAG for Bool properties in Blender?▼

You need to use ENUM_FLAG when creating an EnumProperty in the Blender Python API that allows multiple simultaneous selections, treating enum items as bitwise flags rather than exclusive single-choice options.

Related Skills

Explore More Software Engineering Skills→
nyaariumnyaarium
4

development

Guide Blender addon development, debugging across Windows and WSL, and deployment.

Community
Intermediate
OpenAEC-FoundationOpenAEC-Foundation
30

blender-syntax-panels

Define Blender Python UI panels, menus, and UI lists with the bpy API.

Official
Intermediate
OpenAEC-FoundationOpenAEC-Foundation
30

sverchok-impl-parametric

Generate parametric AEC geometry in Blender using Sverchok node trees.

Official
Advanced
Impertio-StudioImpertio-Studio
30

blender-syntax-properties

Enforce correct bpy.props declaration syntax and callback safety for Blender objects.

Official
Advanced