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

blender-errors-data

Diagnose Python ReferenceError causes in Blender bpy.data access across versions.

30|4|Updated Mar 5, 2026
Search Tags:#debugging#python#scripting#blender#bpy.data#referenceerror
One-click install
npx skills add https://github.com/OpenAEC-Foundation/Blender-Bonsai-ifcOpenshell-Sverchok-Claude-Skill-Package --skill blender-errors-data
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: blender-errors-data
Source: https://github.com/OpenAEC-Foundation/Blender-Bonsai-ifcOpenshell-Sverchok-Claude-Skill-Package/tree/main/skills/blender/errors/blender-errors-data
Command: npx skills add https://github.com/OpenAEC-Foundation/Blender-Bonsai-ifcOpenshell-Sverchok-Claude-Skill-Package --skill blender-errors-data

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill helps developers diagnose and fix common ReferenceError and other data access issues in Blender Python scripting, ensuring scripts remain stable across undo/redo, file operations, and version updates.

Core Features & Use Cases

  • Error Diagnosis: Identifies root causes for ReferenceError, KeyError, and crashes related to stale data pointers.
  • Safe Data Patterns: Provides clear rules and decision trees for robust bpy.data access.
  • Version Compatibility: Addresses specific pitfalls in Blender 5.0+ IDProperty changes.
  • Use Case: A script crashes after a user performs an undo operation. This Skill helps identify that direct bpy.data references were stored and guides the developer to use name-based lookups instead.

Quick Start

Use the blender-errors-data skill to understand why accessing bpy.data after an undo operation causes a ReferenceError.

Frequently Asked Questions about blender-errors-data

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

FAQPage Schema
Why does my Blender Python script throw a ReferenceError after an undo operation?▼

A ReferenceError occurs because undo invalidates bpy.data references, making stored pointers stale. This Skill diagnoses these Blender Python data access errors and guides developers to use safe name-based lookups instead of direct reference caching.

How do I fix stale bpy.data references after file operations in Blender?▼

To fix stale ID pointers after file operations, avoid caching bpy.data references. This Skill provides decision trees for robust bpy.data access, ensuring scripts remain stable across file operations and Blender version updates.

What is the best way to safely access bpy.data collections in Blender Python?▼

The best way to safely access bpy.data collections is to avoid storing ID pointers directly. This Skill provides clear rules for proper data lifecycle management and safe data access patterns across all Blender versions.

Are there specific bpy.data access pitfalls in Blender 5.0 Python scripting?▼

Yes, Blender 5.0+ introduces specific IDProperty changes that affect data access. This Skill addresses these version compatibility pitfalls, helping developers diagnose and fix crashes related to stale data pointers.

How do I prevent my Blender add-on from crashing when users undo or redo?▼

Prevent crashes by avoiding direct bpy.data reference storage and using name-based lookups. This Skill identifies root causes for ReferenceError and KeyError issues, providing safe data patterns for undo/redo stability.

Related Skills

Explore More Software Engineering Skills→
OpenAEC-FoundationOpenAEC-Foundation
30

blender-core-api

Guide Blender Python API usage for bpy scripts and addons.

Official
Advanced
Impertio-StudioImpertio-Studio
30

blender-errors-data

Prevents Blender Python ReferenceError and crash scenarios from stale bpy.data references.

Official
Intermediate
ArabelaTsoArabelaTso
142

failure-oriented-instrumentation

Instrument suspicious code regions with logging, tracing, and assertions.

Community
Intermediate
2025Emma2025Emma
22.7k

postgresql

Provide PostgreSQL development and administration guidance for SQL, schemas, and performance tuning.

Community
Advanced