[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7FA5CJEMM7SGTS5H5DTHD76":3,"skill-same:01M7FA5CJEMM7SGTS5H5DTHD76":62},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":28,"commitSha":29,"skillDirectory":30,"forksCount":13,"repositoryHtmlUrl":31,"repositoryHomepageUrl":6,"ownerHtmlUrl":32,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":33,"install":34,"resources":47},"01M7FA5CJEMM7SGTS5H5DTHD76","blender-syntax-properties",null,"Use when adding custom properties to Blender objects -- BoolProperty, IntProperty, FloatProperty, EnumProperty, PointerProperty, or PropertyGroup. Prevents the common mistake of not using update callbacks (changes not reflected in UI) or returning stale items from dynamic EnumProperty. Covers all bpy.props types, subtypes, units, getters\u002F setters, and CollectionProperty patterns. Keywords: bpy.props, PropertyGroup, BoolProperty, IntProperty, FloatProperty, EnumProperty, PointerProperty, CollectionProperty, update callback, dynamic enum, add custom property, user input, settings.","lagzgabrielmuller-dot\u002Fkit-ingenieria-3d","lagzgabrielmuller-dot","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F333339260?v=4","01M7F985KYC0XB2XZ97B5YWH4C","01M7F985MHK8N2NVE4VAR5WBWS",0,"MIT","https:\u002F\u002Fgithub.com\u002Flagzgabrielmuller-dot\u002Fkit-ingenieria-3d\u002Fblob\u002Fmain\u002Fplugins\u002Fblender-bim-sverchok\u002Fskills\u002Fblender\u002Fsyntax\u002Fblender-syntax-properties\u002FSKILL.md",[],[],"2026-11-16 10:05:34",false,"---\nname: blender-syntax-properties\ndescription: >\n  Use when adding custom properties to Blender objects -- BoolProperty, IntProperty,\n  FloatProperty, EnumProperty, PointerProperty, or PropertyGroup. Prevents the common\n  mistake of not using update callbacks (changes not reflected in UI) or returning stale\n  items from dynamic EnumProperty. Covers all bpy.props types, subtypes, units, getters\u002F\n  setters, and CollectionProperty patterns.\n  Keywords: bpy.props, PropertyGroup, BoolProperty, IntProperty, FloatProperty, EnumProperty, PointerProperty, CollectionProperty, update callback, dynamic enum, add custom property, user input, settings.\nlicense: MIT\ncompatibility: \"Designed for Claude Code. Requires Blender 3.x\u002F4.x\u002F5.x with Python.\"\nmetadata:\n  author: OpenAEC-Foundation\n  version: \"1.0\"\n---\n\n# blender-syntax-properties\n\n## Quick Reference\n\n### Property Type Selection\n\n| Need | Property Type | Python Type |\n|------|---------------|-------------|\n| Toggle\u002Fflag | `BoolProperty` | `bool` |\n| Count\u002Findex | `IntProperty` | `int` |\n| Size\u002Ffactor | `FloatProperty` | `float` |\n| Name\u002Fpath | `StringProperty` | `str` |\n| Dropdown\u002Fmode | `EnumProperty` | `str` (identifier) |\n| Axis toggles (X, Y, Z) | `BoolVectorProperty` | `tuple[bool, ...]` |\n| Dimensions | `IntVectorProperty` | `tuple[int, ...]` |\n| Color\u002Fposition\u002Frotation | `FloatVectorProperty` | `tuple[float, ...]` |\n| Link to another type | `PointerProperty` | Reference to PropertyGroup or ID |\n| Dynamic list | `CollectionProperty` | List of PropertyGroup items |\n\n### Critical Warnings\n\n**ALWAYS** use Python annotation syntax (`:` not `=`) for property declarations in classes.\n\n**ALWAYS** register sub-PropertyGroups BEFORE parent PropertyGroups — registration order matters.\n\n**ALWAYS** store dynamic enum callback results in a module-level variable to prevent garbage collection crashes.\n\n**ALWAYS** set explicit unique integer values in enum items used with `ENUM_FLAG` or getter\u002Fsetter patterns.\n\n**NEVER** modify the property that triggered an `update` callback — causes infinite recursion.\n\n**NEVER** define `set` without a matching `get` callback — Blender raises an error.\n\n**NEVER** call operators inside `update` callbacks — they trigger undo and corrupt state.\n\n**NEVER** set `default` on `EnumProperty` when `items` is a callback — use `default=None` or omit it.\n\n---\n\n## Version-Critical Changes\n\n| Version | Change | Impact |\n|---------|--------|--------|\n| 4.1 | Enum ID properties via `id_properties_ui` | Integer custom properties can display as dropdowns |\n| 5.0 | `property_unset()` replaces `del obj[\"prop\"]` | RNA properties use separate storage from custom properties |\n| 5.0 | `get_transform` \u002F `set_transform` callbacks | Faster alternative to `get`\u002F`set` using internal storage |\n| 5.0 | IDProperty storage split | `bpy.props`-defined properties no longer accessible via dict syntax |\n\n### Blender 5.0 Property Storage Split\n\n```python\n# Blender \u003C5.0: dict access to RNA properties worked\nvalue = obj[\"my_rna_prop\"]  # WORKED in 4.x\n\n# Blender 5.0+: dict access BROKEN for bpy.props-defined properties\nvalue = obj[\"my_rna_prop\"]  # Returns None or KeyError\n\n# CORRECT in 5.0+: use RNA path\nvalue = obj.my_rna_prop\n\n# Reset property to default (replaces del obj[\"prop\"]):\nobj.property_unset(\"my_rna_prop\")\n```\n\n---\n\n## Essential Patterns\n\n### Pattern 1: Basic Property Declaration\n\n```python\n# Blender 3.x\u002F4.x\u002F5.x: annotation syntax REQUIRED\nclass MyOperator(bpy.types.Operator):\n    bl_idname = \"object.my_operator\"\n    bl_label = \"My Operator\"\n\n    count: bpy.props.IntProperty(name=\"Count\", default=5, min=1, max=100)\n    factor: bpy.props.FloatProperty(name=\"Factor\", default=1.0, subtype='FACTOR')\n    name_input: bpy.props.StringProperty(name=\"Name\", default=\"Object\")\n```\n\n### Pattern 2: PropertyGroup Registration\n\n```python\n# Blender 3.x\u002F4.x\u002F5.x\nclass MySettings(bpy.types.PropertyGroup):\n    enabled: bpy.props.BoolProperty(name=\"Enabled\", default=True)\n    count: bpy.props.IntProperty(name=\"Count\", default=5, min=1)\n    scale: bpy.props.FloatProperty(name=\"Scale\", default=1.0, min=0.01)\n\ndef register():\n    bpy.utils.register_class(MySettings)\n    bpy.types.Scene.my_settings = bpy.props.PointerProperty(type=MySettings)\n\ndef unregister():\n    del bpy.types.Scene.my_settings\n    bpy.utils.unregister_class(MySettings)\n```\n\n### Pattern 3: Nested PropertyGroups\n\n```python\n# Blender 3.x\u002F4.x\u002F5.x: registration order is CRITICAL\nclass SubSettings(bpy.types.PropertyGroup):\n    value: bpy.props.FloatProperty(name=\"Value\", default=0.0)\n\nclass MainSettings(bpy.types.PropertyGroup):\n    sub: bpy.props.PointerProperty(type=SubSettings)\n    items: bpy.props.CollectionProperty(type=SubSettings)\n    active_index: bpy.props.IntProperty()\n\ndef register():\n    bpy.utils.register_class(SubSettings)    # FIRST: sub-types\n    bpy.utils.register_class(MainSettings)   # SECOND: parent type\n    bpy.types.Scene.settings = bpy.props.PointerProperty(type=MainSettings)\n\ndef unregister():\n    del bpy.types.Scene.settings\n    bpy.utils.unregister_class(MainSettings)  # Reverse order\n    bpy.utils.unregister_class(SubSettings)\n```\n\n### Pattern 4: Static EnumProperty\n\n```python\n# Blender 3.x\u002F4.x\u002F5.x\n# Items: (identifier, name, description[, icon[, number]])\nmy_mode: bpy.props.EnumProperty(\n    name=\"Mode\",\n    items=[\n        ('FAST', \"Fast\", \"Low quality, fast render\", 'PLAY', 0),\n        ('MEDIUM', \"Medium\", \"Balanced quality\", 'PAUSE', 1),\n        ('HIGH', \"High\", \"High quality, slow render\", 'RENDER_STILL', 2),\n    ],\n    default='MEDIUM',\n)\n```\n\n### Pattern 5: Dynamic EnumProperty\n\n```python\n# Blender 3.x\u002F4.x\u002F5.x\n# WARNING: MUST store results to prevent garbage collection crash\n\n_enum_items_cache = []  # Module-level storage REQUIRED\n\ndef get_object_items(self, context):\n    global _enum_items_cache\n    _enum_items_cache = [\n        (obj.name, obj.name, f\"Select {obj.name}\", 'OBJECT_DATA', i)\n        for i, obj in enumerate(bpy.data.objects)\n    ]\n    if not _enum_items_cache:\n        _enum_items_cache = [('NONE', \"None\", \"No objects available\", 'ERROR', 0)]\n    return _enum_items_cache\n\nmy_object: bpy.props.EnumProperty(\n    name=\"Object\",\n    items=get_object_items,\n    # default MUST be None or omitted when items is a callback\n)\n```\n\n### Pattern 6: Update Callback\n\n```python\n# Blender 3.x\u002F4.x\u002F5.x\ndef on_count_changed(self, context):\n    # SAFE: modify OTHER properties on self\n    if self.count > 10:\n        self.warning = \"High count may impact performance\"\n    # UNSAFE: do NOT modify self.count here (infinite recursion)\n    # UNSAFE: do NOT call bpy.ops.* here (undo corruption)\n\nclass MySettings(bpy.types.PropertyGroup):\n    count: bpy.props.IntProperty(\n        name=\"Count\", default=5, update=on_count_changed,\n    )\n    warning: bpy.props.StringProperty()\n```\n\n### Pattern 7: Getter\u002FSetter\n\n```python\n# Blender 3.x\u002F4.x\u002F5.x\ndef get_computed(self):\n    # Compute value on read — no internal storage\n    return len(bpy.data.objects)\n\ndef set_computed(self, value):\n    # Handle write — must store somewhere if persistence needed\n    self[\"_cached_count\"] = value\n\nclass MySettings(bpy.types.PropertyGroup):\n    object_count: bpy.props.IntProperty(\n        name=\"Object Count\",\n        get=get_computed,\n        set=set_computed,\n    )\n```\n\n### Pattern 8: Get\u002FSet Transform (Blender 5.0+)\n\n```python\n# Blender 5.0+ ONLY: faster than get\u002Fset, uses internal storage\ndef clamp_transform(self, new_value, curr_value, is_set):\n    \"\"\"Transform value before storing.\"\"\"\n    return max(0.0, min(new_value, 100.0))\n\ndef display_transform(self, curr_value, is_set):\n    \"\"\"Transform value on read.\"\"\"\n    return curr_value * 2.0 if is_set else 0.0\n\nclass MySettings(bpy.types.PropertyGroup):\n    clamped: bpy.props.FloatProperty(\n        name=\"Clamped\",\n        set_transform=clamp_transform,\n        get_transform=display_transform,\n    )\n```\n\n### Pattern 9: ENUM_FLAG (Multi-Select)\n\n```python\n# Blender 3.x\u002F4.x\u002F5.x: numbers MUST be powers of 2\nmy_flags: bpy.props.EnumProperty(\n    name=\"Axes\",\n    items=[\n        ('X', \"X Axis\", \"Include X axis\", 1),\n        ('Y', \"Y Axis\", \"Include Y axis\", 2),\n        ('Z', \"Z Axis\", \"Include Z axis\", 4),\n    ],\n    options={'ENUM_FLAG'},\n    default={'X', 'Z'},  # Default is a SET, not a string\n)\n```\n\n### Pattern 10: PointerProperty with Poll\n\n```python\n# Blender 3.x\u002F4.x\u002F5.x: filter selectable objects\ndef filter_mesh_objects(self, obj):\n    return obj.type == 'MESH'\n\nclass MySettings(bpy.types.PropertyGroup):\n    target: bpy.props.PointerProperty(\n        type=bpy.types.Object,\n        name=\"Target\",\n        poll=filter_mesh_objects,\n    )\n```\n\n### Pattern 11: CollectionProperty Operations\n\n```python\n# Blender 3.x\u002F4.x\u002F5.x\nscene = bpy.context.scene\n\n# Add item\nitem = scene.my_settings.items.add()\nitem.name = \"New Item\"\nitem.value = 42.0\n\n# Remove by index\nscene.my_settings.items.remove(0)\n\n# Move item (from_index, to_index)\nscene.my_settings.items.move(0, 2)\n\n# Clear all\nscene.my_settings.items.clear()\n\n# Iterate\nfor item in scene.my_settings.items:\n    print(item.name, item.value)\n\n# Access by index\nfirst = scene.my_settings.items[0]\n\n# Find by name (returns index or -1)\nidx = scene.my_settings.items.find(\"New Item\")\n```\n\n---\n\n## Subtype and Unit Quick Reference\n\n### Numeric Subtypes\n\n| Subtype | Applies To | Effect |\n|---------|-----------|--------|\n| `'NONE'` | All | Default display |\n| `'PIXEL'` | Int\u002FFloat | Pixel unit display |\n| `'UNSIGNED'` | Int | Unsigned display |\n| `'PERCENTAGE'` | Float | 0-100% display |\n| `'FACTOR'` | Float | 0.0-1.0 slider |\n| `'ANGLE'` | Float | Radians with degree display |\n| `'TIME'` | Float | Scene-relative time (frames) |\n| `'TIME_ABSOLUTE'` | Float | Absolute time (seconds) |\n| `'DISTANCE'` | Float | Distance in scene units |\n| `'POWER'` | Float | Power unit display |\n| `'TEMPERATURE'` | Float | Temperature display |\n\n### Vector Subtypes\n\n| Subtype | Applies To | Effect |\n|---------|-----------|--------|\n| `'COLOR'` | FloatVector | Linear RGB color picker |\n| `'COLOR_GAMMA'` | FloatVector | Gamma-space color picker |\n| `'TRANSLATION'` | FloatVector | Position in scene units |\n| `'DIRECTION'` | FloatVector | Normalized direction |\n| `'VELOCITY'` | FloatVector | Velocity vector |\n| `'ACCELERATION'` | FloatVector | Acceleration vector |\n| `'EULER'` | FloatVector | Euler rotation (radians) |\n| `'QUATERNION'` | FloatVector | Quaternion rotation (size=4) |\n| `'AXISANGLE'` | FloatVector | Axis-angle rotation (size=4) |\n| `'XYZ'` | FloatVector | Generic XYZ coordinates |\n| `'MATRIX'` | FloatVector | Matrix representation |\n\n### String Subtypes\n\n| Subtype | Effect |\n|---------|--------|\n| `'NONE'` | Plain text input |\n| `'FILE_PATH'` | File browser button |\n| `'DIR_PATH'` | Directory browser button |\n| `'FILE_NAME'` | File name field |\n| `'BYTE_STRING'` | Byte string |\n| `'PASSWORD'` | Masked input (***) |\n\n### Unit Values (FloatProperty \u002F FloatVectorProperty only)\n\n| Unit | Display |\n|------|---------|\n| `'NONE'` | No unit |\n| `'LENGTH'` | Scene length unit |\n| `'AREA'` | Area (length²) |\n| `'VOLUME'` | Volume (length³) |\n| `'ROTATION'` | Degrees\u002Fradians |\n| `'TIME'` | Scene-relative time |\n| `'TIME_ABSOLUTE'` | Absolute seconds |\n| `'VELOCITY'` | Speed |\n| `'ACCELERATION'` | Acceleration |\n| `'MASS'` | Mass |\n| `'CAMERA'` | Camera distance |\n| `'POWER'` | Power |\n| `'TEMPERATURE'` | Temperature |\n\n### Options Flags\n\n| Flag | Applies To | Effect |\n|------|-----------|--------|\n| `'HIDDEN'` | All | Hidden from UI, accessible via Python |\n| `'SKIP_SAVE'` | All | Value not saved between operator invocations |\n| `'ANIMATABLE'` | All (default) | Can be keyframed |\n| `'LIBRARY_EDITABLE'` | All | Editable on linked data-blocks |\n| `'PROPORTIONAL'` | Numeric | Proportional editing support |\n| `'TEXTEDIT_UPDATE'` | String | Updates on each keystroke |\n| `'ENUM_FLAG'` | Enum only | Multi-select with power-of-2 values |\n\n---\n\n## Decision Trees\n\n### When to Use PointerProperty vs CollectionProperty\n\n```\nNeed to reference ONE item?\n├── YES → PointerProperty\n│   ├── Reference to another PropertyGroup? → type=MyPropertyGroup\n│   └── Reference to an ID type? → type=bpy.types.Object (or Material, etc.)\n└── NO → Need a LIST of items?\n    └── YES → CollectionProperty(type=MyPropertyGroup)\n        └── Track active selection? → Add IntProperty for active_index\n```\n\n### When to Use get\u002Fset vs get_transform\u002Fset_transform\n\n```\nBlender version?\n├── \u003C5.0 → Use get\u002Fset (only option)\n└── >=5.0\n    ├── Need custom storage logic? → Use get\u002Fset\n    └── Only need value transformation?\n        └── Use get_transform\u002Fset_transform (faster, uses internal storage)\n```\n\n### When to Use update vs msgbus\n\n```\nProperty changes on THIS class?\n├── YES → Use update callback on the property\n└── NO → Watching EXTERNAL property changes?\n    └── YES → Use bpy.msgbus.subscribe_rna()\n```\n\n---\n\n## Attachment Points\n\nProperties can be attached to any Blender ID type:\n\n```python\n# Per-scene settings\nbpy.types.Scene.my_prop = bpy.props.PointerProperty(type=MySettings)\n\n# Per-object settings\nbpy.types.Object.my_prop = bpy.props.PointerProperty(type=MySettings)\n\n# Per-material settings\nbpy.types.Material.my_prop = bpy.props.FloatProperty(name=\"Custom\")\n\n# Per-mesh settings\nbpy.types.Mesh.my_prop = bpy.props.IntProperty(name=\"Custom\")\n\n# Per-bone settings\nbpy.types.Bone.my_prop = bpy.props.StringProperty(name=\"Custom\")\n\n# Per-window-manager (session-only, not saved)\nbpy.types.WindowManager.my_prop = bpy.props.BoolProperty(name=\"Temp\")\n```\n\n**WindowManager** properties are session-only — they reset when Blender restarts. Use for temporary UI state.\n\n---\n\n## Reference Links\n\n- [references\u002Fmethods.md](references\u002Fmethods.md) — Complete API signatures for all bpy.props types\n- [references\u002Fexamples.md](references\u002Fexamples.md) — Working code examples for every property pattern\n- [references\u002Fanti-patterns.md](references\u002Fanti-patterns.md) — What NOT to do, with explanations\n\n### Official Sources\n\n- https:\u002F\u002Fdocs.blender.org\u002Fapi\u002Fcurrent\u002Fbpy.props.html\n- https:\u002F\u002Fdocs.blender.org\u002Fapi\u002Fcurrent\u002Fbpy.types.PropertyGroup.html\n- https:\u002F\u002Fdeveloper.blender.org\u002Fdocs\u002Frelease_notes\u002F5.0\u002Fpython_api\u002F\n- https:\u002F\u002Fdeveloper.blender.org\u002Fdocs\u002Frelease_notes\u002F4.1\u002Fpython_api\u002F\n","# blender-syntax-properties\n\n## Quick Reference\n\n### Property Type Selection\n\n| Need | Property Type | Python Type |\n|------|---------------|-------------|\n| Toggle\u002Fflag | `BoolProperty` | `bool` |\n| Count\u002Findex | `IntProperty` | `int` |\n| Size\u002Ffactor | `FloatProperty` | `float` |\n| Name\u002Fpath | `StringProperty` | `str` |\n| Dropdown\u002Fmode | `EnumProperty` | `str` (identifier) |\n| Axis toggles (X, Y, Z) | `BoolVectorProperty` | `tuple[bool, ...]` |\n| Dimensions | `IntVectorProperty` | `tuple[int, ...]` |\n| Color\u002Fposition\u002Frotation | `FloatVectorProperty` | `tuple[float, ...]` |\n| Link to another type | `PointerProperty` | Reference to PropertyGroup or ID |\n| Dynamic list | `CollectionProperty` | List of PropertyGroup items |\n\n### Critical Warnings\n\n**ALWAYS** use Python annotation syntax (`:` not `=`) for property declarations in classes.\n\n**ALWAYS** register sub-PropertyGroups BEFORE parent PropertyGroups — registration order matters.\n\n**ALWAYS** store dynamic enum callback results in a module-level variable to prevent garbage collection crashes.\n\n**ALWAYS** set explicit unique integer values in enum items used with `ENUM_FLAG` or getter\u002Fsetter patterns.\n\n**NEVER** modify the property that triggered an `update` callback — causes infinite recursion.\n\n**NEVER** define `set` without a matching `get` callback — Blender raises an error.\n\n**NEVER** call operators inside `update` callbacks — they trigger undo and corrupt state.\n\n**NEVER** set `default` on `EnumProperty` when `items` is a callback — use `default=None` or omit it.\n\n---\n\n## Version-Critical Changes\n\n| Version | Change | Impact |\n|---------|--------|--------|\n| 4.1 | Enum ID properties via `id_properties_ui` | Integer custom properties can display as dropdowns |\n| 5.0 | `property_unset()` replaces `del obj[\"prop\"]` | RNA properties use separate storage from custom properties |\n| 5.0 | `get_transform` \u002F `set_transform` callbacks | Faster alternative to `get`\u002F`set` using internal storage |\n| 5.0 | IDProperty storage split | `bpy.props`-defined properties no longer accessible via dict syntax |\n\n### Blender 5.0 Property Storage Split\n\n```python\n# Blender \u003C5.0: dict access to RNA properties worked\nvalue = obj[\"my_rna_prop\"]  # WORKED in 4.x\n\n# Blender 5.0+: dict access BROKEN for bpy.props-defined properties\nvalue = obj[\"my_rna_prop\"]  # Returns None or KeyError\n\n# CORRECT in 5.0+: use RNA path\nvalue = obj.my_rna_prop\n\n# Reset property to default (replaces del obj[\"prop\"]):\nobj.property_unset(\"my_rna_prop\")\n```\n\n---\n\n## Essential Patterns\n\n### Pattern 1: Basic Property Declaration\n\n```python\n# Blender 3.x\u002F4.x\u002F5.x: annotation syntax REQUIRED\nclass MyOperator(bpy.types.Operator):\n    bl_idname = \"object.my_operator\"\n    bl_label = \"My Operator\"\n\n    count: bpy.props.IntProperty(name=\"Count\", default=5, min=1, max=100)\n    factor: bpy.props.FloatProperty(name=\"Factor\", default=1.0, subtype='FACTOR')\n    name_input: bpy.props.StringProperty(name=\"Name\", default=\"Object\")\n```\n\n### Pattern 2: PropertyGroup Registration\n\n```python\n# Blender 3.x\u002F4.x\u002F5.x\nclass MySettings(bpy.types.PropertyGroup):\n    enabled: bpy.props.BoolProperty(name=\"Enabled\", default=True)\n    count: bpy.props.IntProperty(name=\"Count\", default=5, min=1)\n    scale: bpy.props.FloatProperty(name=\"Scale\", default=1.0, min=0.01)\n\ndef register():\n    bpy.utils.register_class(MySettings)\n    bpy.types.Scene.my_settings = bpy.props.PointerProperty(type=MySettings)\n\ndef unregister():\n    del bpy.types.Scene.my_settings\n    bpy.utils.unregister_class(MySettings)\n```\n\n### Pattern 3: Nested PropertyGroups\n\n```python\n# Blender 3.x\u002F4.x\u002F5.x: registration order is CRITICAL\nclass SubSettings(bpy.types.PropertyGroup):\n    value: bpy.props.FloatProperty(name=\"Value\", default=0.0)\n\nclass MainSettings(bpy.types.PropertyGroup):\n    sub: bpy.props.PointerProperty(type=SubSettings)\n    items: bpy.props.CollectionProperty(type=SubSettings)\n    active_index: bpy.props.IntProperty()\n\ndef register():\n    bpy.utils.register_class(SubSettings)    # FIRST: sub-types\n    bpy.utils.register_class(MainSettings)   # SECOND: parent type\n    bpy.types.Scene.settings = bpy.props.PointerProperty(type=MainSettings)\n\ndef unregister():\n    del bpy.types.Scene.settings\n    bpy.utils.unregister_class(MainSettings)  # Reverse order\n    bpy.utils.unregister_class(SubSettings)\n```\n\n### Pattern 4: Static EnumProperty\n\n```python\n# Blender 3.x\u002F4.x\u002F5.x\n# Items: (identifier, name, description[, icon[, number]])\nmy_mode: bpy.props.EnumProperty(\n    name=\"Mode\",\n    items=[\n        ('FAST', \"Fast\", \"Low quality, fast render\", 'PLAY', 0),\n        ('MEDIUM', \"Medium\", \"Balanced quality\", 'PAUSE', 1),\n        ('HIGH', \"High\", \"High quality, slow render\", 'RENDER_STILL', 2),\n    ],\n    default='MEDIUM',\n)\n```\n\n### Pattern 5: Dynamic EnumProperty\n\n```python\n# Blender 3.x\u002F4.x\u002F5.x\n# WARNING: MUST store results to prevent garbage collection crash\n\n_enum_items_cache = []  # Module-level storage REQUIRED\n\ndef get_object_items(self, context):\n    global _enum_items_cache\n    _enum_items_cache = [\n        (obj.name, obj.name, f\"Select {obj.name}\", 'OBJECT_DATA', i)\n        for i, obj in enumerate(bpy.data.objects)\n    ]\n    if not _enum_items_cache:\n        _enum_items_cache = [('NONE', \"None\", \"No objects available\", 'ERROR', 0)]\n    return _enum_items_cache\n\nmy_object: bpy.props.EnumProperty(\n    name=\"Object\",\n    items=get_object_items,\n    # default MUST be None or omitted when items is a callback\n)\n```\n\n### Pattern 6: Update Callback\n\n```python\n# Blender 3.x\u002F4.x\u002F5.x\ndef on_count_changed(self, context):\n    # SAFE: modify OTHER properties on self\n    if self.count > 10:\n        self.warning = \"High count may impact performance\"\n    # UNSAFE: do NOT modify self.count here (infinite recursion)\n    # UNSAFE: do NOT call bpy.ops.* here (undo corruption)\n\nclass MySettings(bpy.types.PropertyGroup):\n    count: bpy.props.IntProperty(\n        name=\"Count\", default=5, update=on_count_changed,\n    )\n    warning: bpy.props.StringProperty()\n```\n\n### Pattern 7: Getter\u002FSetter\n\n```python\n# Blender 3.x\u002F4.x\u002F5.x\ndef get_computed(self):\n    # Compute value on read — no internal storage\n    return len(bpy.data.objects)\n\ndef set_computed(self, value):\n    # Handle write — must store somewhere if persistence needed\n    self[\"_cached_count\"] = value\n\nclass MySettings(bpy.types.PropertyGroup):\n    object_count: bpy.props.IntProperty(\n        name=\"Object Count\",\n        get=get_computed,\n        set=set_computed,\n    )\n```\n\n### Pattern 8: Get\u002FSet Transform (Blender 5.0+)\n\n```python\n# Blender 5.0+ ONLY: faster than get\u002Fset, uses internal storage\ndef clamp_transform(self, new_value, curr_value, is_set):\n    \"\"\"Transform value before storing.\"\"\"\n    return max(0.0, min(new_value, 100.0))\n\ndef display_transform(self, curr_value, is_set):\n    \"\"\"Transform value on read.\"\"\"\n    return curr_value * 2.0 if is_set else 0.0\n\nclass MySettings(bpy.types.PropertyGroup):\n    clamped: bpy.props.FloatProperty(\n        name=\"Clamped\",\n        set_transform=clamp_transform,\n        get_transform=display_transform,\n    )\n```\n\n### Pattern 9: ENUM_FLAG (Multi-Select)\n\n```python\n# Blender 3.x\u002F4.x\u002F5.x: numbers MUST be powers of 2\nmy_flags: bpy.props.EnumProperty(\n    name=\"Axes\",\n    items=[\n        ('X', \"X Axis\", \"Include X axis\", 1),\n        ('Y', \"Y Axis\", \"Include Y axis\", 2),\n        ('Z', \"Z Axis\", \"Include Z axis\", 4),\n    ],\n    options={'ENUM_FLAG'},\n    default={'X', 'Z'},  # Default is a SET, not a string\n)\n```\n\n### Pattern 10: PointerProperty with Poll\n\n```python\n# Blender 3.x\u002F4.x\u002F5.x: filter selectable objects\ndef filter_mesh_objects(self, obj):\n    return obj.type == 'MESH'\n\nclass MySettings(bpy.types.PropertyGroup):\n    target: bpy.props.PointerProperty(\n        type=bpy.types.Object,\n        name=\"Target\",\n        poll=filter_mesh_objects,\n    )\n```\n\n### Pattern 11: CollectionProperty Operations\n\n```python\n# Blender 3.x\u002F4.x\u002F5.x\nscene = bpy.context.scene\n\n# Add item\nitem = scene.my_settings.items.add()\nitem.name = \"New Item\"\nitem.value = 42.0\n\n# Remove by index\nscene.my_settings.items.remove(0)\n\n# Move item (from_index, to_index)\nscene.my_settings.items.move(0, 2)\n\n# Clear all\nscene.my_settings.items.clear()\n\n# Iterate\nfor item in scene.my_settings.items:\n    print(item.name, item.value)\n\n# Access by index\nfirst = scene.my_settings.items[0]\n\n# Find by name (returns index or -1)\nidx = scene.my_settings.items.find(\"New Item\")\n```\n\n---\n\n## Subtype and Unit Quick Reference\n\n### Numeric Subtypes\n\n| Subtype | Applies To | Effect |\n|---------|-----------|--------|\n| `'NONE'` | All | Default display |\n| `'PIXEL'` | Int\u002FFloat | Pixel unit display |\n| `'UNSIGNED'` | Int | Unsigned display |\n| `'PERCENTAGE'` | Float | 0-100% display |\n| `'FACTOR'` | Float | 0.0-1.0 slider |\n| `'ANGLE'` | Float | Radians with degree display |\n| `'TIME'` | Float | Scene-relative time (frames) |\n| `'TIME_ABSOLUTE'` | Float | Absolute time (seconds) |\n| `'DISTANCE'` | Float | Distance in scene units |\n| `'POWER'` | Float | Power unit display |\n| `'TEMPERATURE'` | Float | Temperature display |\n\n### Vector Subtypes\n\n| Subtype | Applies To | Effect |\n|---------|-----------|--------|\n| `'COLOR'` | FloatVector | Linear RGB color picker |\n| `'COLOR_GAMMA'` | FloatVector | Gamma-space color picker |\n| `'TRANSLATION'` | FloatVector | Position in scene units |\n| `'DIRECTION'` | FloatVector | Normalized direction |\n| `'VELOCITY'` | FloatVector | Velocity vector |\n| `'ACCELERATION'` | FloatVector | Acceleration vector |\n| `'EULER'` | FloatVector | Euler rotation (radians) |\n| `'QUATERNION'` | FloatVector | Quaternion rotation (size=4) |\n| `'AXISANGLE'` | FloatVector | Axis-angle rotation (size=4) |\n| `'XYZ'` | FloatVector | Generic XYZ coordinates |\n| `'MATRIX'` | FloatVector | Matrix representation |\n\n### String Subtypes\n\n| Subtype | Effect |\n|---------|--------|\n| `'NONE'` | Plain text input |\n| `'FILE_PATH'` | File browser button |\n| `'DIR_PATH'` | Directory browser button |\n| `'FILE_NAME'` | File name field |\n| `'BYTE_STRING'` | Byte string |\n| `'PASSWORD'` | Masked input (***) |\n\n### Unit Values (FloatProperty \u002F FloatVectorProperty only)\n\n| Unit | Display |\n|------|---------|\n| `'NONE'` | No unit |\n| `'LENGTH'` | Scene length unit |\n| `'AREA'` | Area (length²) |\n| `'VOLUME'` | Volume (length³) |\n| `'ROTATION'` | Degrees\u002Fradians |\n| `'TIME'` | Scene-relative time |\n| `'TIME_ABSOLUTE'` | Absolute seconds |\n| `'VELOCITY'` | Speed |\n| `'ACCELERATION'` | Acceleration |\n| `'MASS'` | Mass |\n| `'CAMERA'` | Camera distance |\n| `'POWER'` | Power |\n| `'TEMPERATURE'` | Temperature |\n\n### Options Flags\n\n| Flag | Applies To | Effect |\n|------|-----------|--------|\n| `'HIDDEN'` | All | Hidden from UI, accessible via Python |\n| `'SKIP_SAVE'` | All | Value not saved between operator invocations |\n| `'ANIMATABLE'` | All (default) | Can be keyframed |\n| `'LIBRARY_EDITABLE'` | All | Editable on linked data-blocks |\n| `'PROPORTIONAL'` | Numeric | Proportional editing support |\n| `'TEXTEDIT_UPDATE'` | String | Updates on each keystroke |\n| `'ENUM_FLAG'` | Enum only | Multi-select with power-of-2 values |\n\n---\n\n## Decision Trees\n\n### When to Use PointerProperty vs CollectionProperty\n\n```\nNeed to reference ONE item?\n├── YES → PointerProperty\n│   ├── Reference to another PropertyGroup? → type=MyPropertyGroup\n│   └── Reference to an ID type? → type=bpy.types.Object (or Material, etc.)\n└── NO → Need a LIST of items?\n    └── YES → CollectionProperty(type=MyPropertyGroup)\n        └── Track active selection? → Add IntProperty for active_index\n```\n\n### When to Use get\u002Fset vs get_transform\u002Fset_transform\n\n```\nBlender version?\n├── \u003C5.0 → Use get\u002Fset (only option)\n└── >=5.0\n    ├── Need custom storage logic? → Use get\u002Fset\n    └── Only need value transformation?\n        └── Use get_transform\u002Fset_transform (faster, uses internal storage)\n```\n\n### When to Use update vs msgbus\n\n```\nProperty changes on THIS class?\n├── YES → Use update callback on the property\n└── NO → Watching EXTERNAL property changes?\n    └── YES → Use bpy.msgbus.subscribe_rna()\n```\n\n---\n\n## Attachment Points\n\nProperties can be attached to any Blender ID type:\n\n```python\n# Per-scene settings\nbpy.types.Scene.my_prop = bpy.props.PointerProperty(type=MySettings)\n\n# Per-object settings\nbpy.types.Object.my_prop = bpy.props.PointerProperty(type=MySettings)\n\n# Per-material settings\nbpy.types.Material.my_prop = bpy.props.FloatProperty(name=\"Custom\")\n\n# Per-mesh settings\nbpy.types.Mesh.my_prop = bpy.props.IntProperty(name=\"Custom\")\n\n# Per-bone settings\nbpy.types.Bone.my_prop = bpy.props.StringProperty(name=\"Custom\")\n\n# Per-window-manager (session-only, not saved)\nbpy.types.WindowManager.my_prop = bpy.props.BoolProperty(name=\"Temp\")\n```\n\n**WindowManager** properties are session-only — they reset when Blender restarts. Use for temporary UI state.\n\n---\n\n## Reference Links\n\n- [references\u002Fmethods.md](references\u002Fmethods.md) — Complete API signatures for all bpy.props types\n- [references\u002Fexamples.md](references\u002Fexamples.md) — Working code examples for every property pattern\n- [references\u002Fanti-patterns.md](references\u002Fanti-patterns.md) — What NOT to do, with explanations\n\n### Official Sources\n\n- https:\u002F\u002Fdocs.blender.org\u002Fapi\u002Fcurrent\u002Fbpy.props.html\n- https:\u002F\u002Fdocs.blender.org\u002Fapi\u002Fcurrent\u002Fbpy.types.PropertyGroup.html\n- https:\u002F\u002Fdeveloper.blender.org\u002Fdocs\u002Frelease_notes\u002F5.0\u002Fpython_api\u002F\n- https:\u002F\u002Fdeveloper.blender.org\u002Fdocs\u002Frelease_notes\u002F4.1\u002Fpython_api\u002F\n",{"name":5,"license":14,"metadata":23,"description":26,"compatibility":27},{"author":24,"version":25},"OpenAEC-Foundation","1.0","Use when adding custom properties to Blender objects -- BoolProperty, IntProperty, FloatProperty, EnumProperty, PointerProperty, or PropertyGroup. Prevents the common mistake of not using update callbacks (changes not reflected in UI) or returning stale items from dynamic EnumProperty. Covers all bpy.props types, subtypes, units, getters\u002F setters, and CollectionProperty patterns. Keywords: bpy.props, PropertyGroup, BoolProperty, IntProperty, FloatProperty, EnumProperty, PointerProperty, CollectionProperty, update callback, dynamic enum, add custom property, user input, settings.\n","Designed for Claude Code. Requires Blender 3.x\u002F4.x\u002F5.x with Python.","main","9bb7acf0c2ec4f44373969cb14e55af3c9a8385f","plugins\u002Fblender-bim-sverchok\u002Fskills\u002Fblender\u002Fsyntax\u002Fblender-syntax-properties","https:\u002F\u002Fgithub.com\u002Flagzgabrielmuller-dot\u002Fkit-ingenieria-3d","https:\u002F\u002Fgithub.com\u002Flagzgabrielmuller-dot","2026-11-09 13:26:47",{"source":8,"skillName":5,"commands":35,"prompt":45,"zipAvailable":46},[36,39,42],{"tool":37,"command":38},"npx","npx skills add lagzgabrielmuller-dot\u002Fkit-ingenieria-3d --skill blender-syntax-properties",{"tool":40,"command":41},"bunx","bunx skills add lagzgabrielmuller-dot\u002Fkit-ingenieria-3d --skill blender-syntax-properties",{"tool":43,"command":44},"pnpm","pnpm dlx skills add lagzgabrielmuller-dot\u002Fkit-ingenieria-3d --skill blender-syntax-properties","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Flagzgabrielmuller-dot\u002Fkit-ingenieria-3d\u002Fblob\u002Fmain\u002Fplugins\u002Fblender-bim-sverchok\u002Fskills\u002Fblender\u002Fsyntax\u002Fblender-syntax-properties\u002FSKILL.md",true,[48,54,58],{"path":49,"resourceType":50,"resourceTypeDesc":51,"sizeBytes":52,"sourceHtmlUrl":53},"references\u002Fanti-patterns.md","REFERENCE","参考文档",12949,"https:\u002F\u002Fgithub.com\u002Flagzgabrielmuller-dot\u002Fkit-ingenieria-3d\u002Fblob\u002Fmain\u002Fplugins\u002Fblender-bim-sverchok\u002Fskills\u002Fblender\u002Fsyntax\u002Fblender-syntax-properties\u002Freferences\u002Fanti-patterns.md",{"path":55,"resourceType":50,"resourceTypeDesc":51,"sizeBytes":56,"sourceHtmlUrl":57},"references\u002Fexamples.md",20755,"https:\u002F\u002Fgithub.com\u002Flagzgabrielmuller-dot\u002Fkit-ingenieria-3d\u002Fblob\u002Fmain\u002Fplugins\u002Fblender-bim-sverchok\u002Fskills\u002Fblender\u002Fsyntax\u002Fblender-syntax-properties\u002Freferences\u002Fexamples.md",{"path":59,"resourceType":50,"resourceTypeDesc":51,"sizeBytes":60,"sourceHtmlUrl":61},"references\u002Fmethods.md",15013,"https:\u002F\u002Fgithub.com\u002Flagzgabrielmuller-dot\u002Fkit-ingenieria-3d\u002Fblob\u002Fmain\u002Fplugins\u002Fblender-bim-sverchok\u002Fskills\u002Fblender\u002Fsyntax\u002Fblender-syntax-properties\u002Freferences\u002Fmethods.md",[63,71,78,85,92,99],{"skillNo":64,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":67,"sourceHtmlUrl":68,"categories":69,"keywords":70,"publishedAt":18},"01M7FBFSZ93YM463CGS91D0TZG","manimce-best-practices","Trigger when: (1) User mentions \"manim\" or \"Manim Community\" or \"ManimCE\", (2) Code contains `from manim import *`, (3) User runs `manim` CLI commands, (4) Working with Scene, MathTex, Create(), or ManimCE-specific classes.\n\nBest practices for Manim Community Edition - the community-maintained Python animation engine. Covers Scene structure, animations, LaTeX\u002FMathTex, 3D with ThreeDScene, camera control, styling, and CLI usage.\n\nNOT for ManimGL\u002F3b1b version (which uses `manimlib` imports and `manimgl` CLI).","https:\u002F\u002Fgithub.com\u002Flagzgabrielmuller-dot\u002Fkit-ingenieria-3d\u002Fblob\u002Fmain\u002Fplugins\u002Fmanim-animaciones\u002Fskills\u002Fmanimce-best-practices\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Flagzgabrielmuller-dot\u002Fkit-ingenieria-3d\u002Fblob\u002Fmain\u002Fplugins\u002Fmanim-animaciones\u002Fskills\u002Fmanimce-best-practices\u002FSKILL.md",[],[],{"skillNo":72,"name":73,"nameZh":6,"description":74,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"publishedAt":18},"01M7FB2K59HNNXS9WKHAMWHC3C","drawio","Create, edit, replicate, import, and export draw.io diagrams with an offline YAML-first workflow: architecture, network topologies, flowcharts, UML\u002FER, org charts, Mermaid\u002FCSV conversion, existing .drawio bundles, style presets, themes, and non-publication formula diagrams. For publication figures (paper, thesis, IEEE, camera-ready) use drawio-academic-skills instead.","https:\u002F\u002Fgithub.com\u002Flagzgabrielmuller-dot\u002Fkit-ingenieria-3d\u002Fblob\u002Fmain\u002Fplugins\u002Fdiagramas-y-documentos\u002Fskills\u002Fdrawio\u002FSKILL.md",[],[],{"skillNo":79,"name":80,"nameZh":6,"description":81,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":18},"01M7FB2BWX7GWK9H2X8BGCYDDD","drawio-academic-skills","Publication-figure overlay for draw.io. Use instead of drawio whenever the diagram is for a paper, thesis, dissertation, journal, conference, IEEE\u002FACM submission, manuscript, camera-ready, Word\u002FLaTeX figure, or other publication. Applies venue, figure-type, color, caption\u002Flegend, formula, and paper-readability gates for architecture, workflow, roadmap, network-topology, and replicated paper figures.","https:\u002F\u002Fgithub.com\u002Flagzgabrielmuller-dot\u002Fkit-ingenieria-3d\u002Fblob\u002Fmain\u002Fplugins\u002Fdiagramas-y-documentos\u002Fskills\u002Fdrawio-academic-skills\u002FSKILL.md",[],[],{"skillNo":86,"name":87,"nameZh":6,"description":88,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":18},"01M7FB22JESEAV8T15DJT3D444","uncertainty-and-units","Tracks physical units and propagates measurement uncertainty in scientific calculations using pint and uncertainties. Use for unit conversion and dimensional checking, GUM uncertainty budgets, Type A and Type B evaluation, coverage factors and expanded uncertainty, Monte Carlo propagation, significant-figure and plus-minus reporting, error propagation through curve fits, CODATA constants, auditing Python code for stripped units or broken uncertainty propagation, and order-of-magnitude plausibility checks using dimensionless groups (Reynolds, Peclet, Damkohler, Knudsen, Biot, Womersley), characteristic scales such as diffusion time or Debye length, and observed magnitude ranges. Trigger on \"is this number physically reasonable\", \"sanity check these units\", \"what regime is this flow in\", or a result that looks off by orders of magnitude.","https:\u002F\u002Fgithub.com\u002Flagzgabrielmuller-dot\u002Fkit-ingenieria-3d\u002Fblob\u002Fmain\u002Fplugins\u002Fciencia-y-calculo\u002Fskills\u002Funcertainty-and-units\u002FSKILL.md",[],[],{"skillNo":93,"name":94,"nameZh":6,"description":95,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":96,"categories":97,"keywords":98,"publishedAt":18},"01M7FB1ANRSG28R335FDY9SA3R","statistical-analysis","Guided statistical analysis for research data - test selection, assumption checking, effect sizes, power analysis, Bayesian alternatives, and APA-formatted reporting. Use whenever a user wants to compare groups, test a hypothesis, analyze experimental or survey data, check statistical assumptions, compute required sample sizes, or write up results - even if they never name a specific test. Covers t-tests, ANOVA, chi-square, correlation, regression, non-parametric and Bayesian methods. For low-level model APIs, see the statsmodels and pymc skills.","https:\u002F\u002Fgithub.com\u002Flagzgabrielmuller-dot\u002Fkit-ingenieria-3d\u002Fblob\u002Fmain\u002Fplugins\u002Fciencia-y-calculo\u002Fskills\u002Fstatistical-analysis\u002FSKILL.md",[],[],{"skillNo":100,"name":101,"nameZh":6,"description":102,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":103,"categories":104,"keywords":105,"publishedAt":18},"01M7FB15KRA9D7JCPH4P9T6XJY","simpy","Builds, inspects, tests, and analyzes bounded process-based discrete-event simulations with SimPy. Use for event scheduling, resource queues, interrupts, monitoring, independent replications, warm-up, and reproducible output analysis.","https:\u002F\u002Fgithub.com\u002Flagzgabrielmuller-dot\u002Fkit-ingenieria-3d\u002Fblob\u002Fmain\u002Fplugins\u002Fciencia-y-calculo\u002Fskills\u002Fsimpy\u002FSKILL.md",[],[]]