# Character migrator workflow integration (2026-02-18 23:39Z)
_**User**_
We're going to do a major overhaul. Everything that came before is obsolete. I have designed a character migrator workflow. We will integrate it into this project. Here's the context for the workflow:@a:\1 Amazon_Active_Projects\260206_PAE_2026\.specstory\history\2026-02-17_17-20Z-linked-library-override-resync-issue.md
---
_**Agent (model default, mode Agent)**_
Thought Process
The user wants to do a major overhaul of the Dynamic-Link-Manager project. They've designed a "character migrator workflow" and want to integrate it. They've referenced a spec story history file that contains the context for the workflow. I need to:
1. Read the referenced file to understand the character migrator workflow design
2. Understand the current state of the Dynamic-Link-Manager project
3. Create a plan for integrating the workflow into the project
Let me start by reading the referenced file and exploring the current project structure. I'm in plan mode, so I should not make any edits - only gather information and create a plan.
Tool use: **read_file_v2** • Read file: a:\1 Amazon_Active_Projects\260206_PAE_2026\.specstory\history\2026-02-17_17-20Z-linked-library-override-resync-issue.md
Tool use: **read_file_v2** • Read file: T:\Dynamic-Link-Manager\blender_manifest.toml
Thought Process
The spec story file is huge (over 1M characters). I need to read it in chunks or search for the character migrator workflow design. Let me read the beginning of the file to understand its structure, and search for key terms like "character migrator", "workflow", "migrator", etc.
Tool use: **read_file_v2** • Read file: a:\1 Amazon_Active_Projects\260206_PAE_2026\.specstory\history\2026-02-17_17-20Z-linked-library-override-resync-issue.md
Tool use: **ripgrep_raw_search**
Parameters:
```json
{
"pattern": "character migrator|migrator workflow|migrator",
"path": "a:\\1 Amazon_Active_Projects\\260206_PAE_2026\\.specstory\\history\\2026-02-17_17-20Z-linked-library-override-resync-issue.md",
"contextBefore": 0,
"contextAfter": 0,
"caseInsensitive": true
}
```
Additional data:
```json
{
"isPruned": true,
"pattern": "character migrator|migrator workflow|migrator",
"path": "a:\\1 Amazon_Active_Projects\\260206_PAE_2026\\.specstory\\history\\2026-02-17_17-20Z-linked-library-override-resync-issue.md",
"outputMode": "content",
"totalFiles": 0,
"totalMatches": 0,
"topFiles": []
}
```
Status: **completed**
---
Tool use: **glob_file_search** • Searched codebase "undefined" • **13** results in **1** directory
Directory: **T:\Dynamic-Link-Manager** (13 files)
| File |
|------|
| `../blender_manifest.toml` |
| `../.specstory\history\2025-08-20_22-43Z-creating-a-blender-extension-for-asset-replacement.md` |
| `../__pycache__\operators.cpython-311.pyc` |
| `../.specstory\.gitignore` |
| `../.specstory\.project.json` |
| `../.specstory/.gitignore` |
| `../.cursorindexingignore` |
| `../.specstory/history/2025-08-20_22-43Z-creating-a-blender-extension-for-asset-replacement.md` |
| `../.gitignore` |
| `../ui.py` |
| `../.specstory\.what-is-this.md` |
| `../__init__.py` |
| `../operators.py` |
---
Thought Process
The spec file is a long transcript about a linked library override resync issue in Blender - it doesn't seem to contain the words "character migrator" or "migrator workflow". The user said they "designed a character migrator workflow" and the context is in that file. Maybe the design appears later in the document, or under different terms. Let me search for other keywords: "workflow", "migrat", "design", "overhaul", "character", or look at the end of the file where conclusions/design might be.
Tool use: **ripgrep_raw_search**
Parameters:
```json
{
"pattern": "workflow|migrat|design|overhaul|character",
"path": "a:\\1 Amazon_Active_Projects\\260206_PAE_2026\\.specstory\\history\\2026-02-17_17-20Z-linked-library-override-resync-issue.md",
"contextBefore": 0,
"contextAfter": 0,
"caseInsensitive": true
}
```
Additional data:
```json
{
"isPruned": true,
"pattern": "workflow|migrat|design|overhaul|character",
"path": "a:\\1 Amazon_Active_Projects\\260206_PAE_2026\\.specstory\\history\\2026-02-17_17-20Z-linked-library-override-resync-issue.md",
"outputMode": "content",
"totalFiles": 1,
"totalMatches": 256,
"topFiles": [
{
"uri": "a:\\1 Amazon_Active_Projects\\260206_PAE_2026\\.specstory\\history\\2026-02-17_17-20Z-linked-library-override-resync-issue.md",
"matchCount": 80
}
]
}
```
Status: **completed**
---
Tool use: **read_file_v2** • Read file: a:\1 Amazon_Active_Projects\260206_PAE_2026\.specstory\history\2026-02-17_17-20Z-linked-library-override-resync-issue.md
Tool use: **read_file_v2** • Read file: T:\Dynamic-Link-Manager\__init__.py
Tool use: **read_file_v2** • Read file: T:\Dynamic-Link-Manager\operators.py
Thought Process
I'm getting a clearer picture. The spec story is a long transcript of a Blender support session. It evolved into a **character replacement/migration workflow** that was run repeatedly for different characters (Una, Steve, Eddy, Hailey). The workflow is not explicitly named "character migrator" in the doc but it's clearly the same thing. Key elements from the transcript:
**The workflow (steps 1–7):**
1. **Copy attributes** – Copy rotation, location, scale on each armature object from original to replacement (and link/override characters if needed).
2. **Migrate NLA** – Copy NLA tracks from original to replacement, with blend_type matched (e.g. COMBINE).
3. **Custom properties** – Copy pose-bone custom props from original to replacement (exclude _RNA_UI, rigify_type, rigify_parameters).
4. **Bone constraints** – Copy constraints to replacement; skip when target is same character's original; **retarget** when target is another character's original → that character's replacement; remove stale constraints on rep that target other's original first.
5. **Retarget relations** – Parents, constraint targets, Armature modifiers pointing at original → point to replacement; also objects outside the character that target the original.
6. **Replacement base body** – **Library override only** (NO single-user copy): for rep's base body mesh, if linked call `override_create()`, then assign shape-key action. Do NOT do ob.data.copy().
7. **Remove duplicate constraints** – Trim rep's bone constraints so count matches original (remove from end).
**Additional rules from the transcript:**
- When replacing an armature, update any relations (objects/empties, constraints, modifiers, drivers, parenting) that point to the old armature to point to the new one.
- Cross-character constraints: e.g. Eddy looking at Hailey → when copying to Eddy.001, retarget the constraint to Hailey.001; and remove from the rep any constraint that still targets the other character's *original* before re-adding with correct target.
- NLA strip blend_type should be copied (e.g. COMBINE).
- Optional: COPY_TRANSFORMS on control bones from original to replacement so they move together – but user also wanted "Steve.001 independent" (no dependency on Steve), so sometimes skip COPY_TRANSFORMS.
**Current Dynamic-Link-Manager project:**
- Blender add-on: "Dynamic Link Manager" – relink characters and library blends.
- Has operators for: replace_linked_asset, scan_linked_assets, and likely more (relink, path management).
- UI in ui.py, logic in operators.py.
The user wants to:
1. Treat everything before as obsolete.
2. Integrate this **character migrator workflow** into the Dynamic-Link-Manager project.
So the plan is: **Major overhaul** – replace or significantly reshape the add-on around the character migrator workflow (detect original/replacement armature pairs, run steps 1–7 with the rules above). I need to read more of the spec to see if there's a canonical step list or any more design (e.g. how to discover "pairs", UI, etc.) and also read more of operators.py and ui.py to see what to remove or keep.
Tool use: **ripgrep_raw_search**
Parameters:
```json
{
"pattern": "Step [0-9]|step [0-9]|get_pairs|orig.*rep|workflow",
"path": "a:\\1 Amazon_Active_Projects\\260206_PAE_2026\\.specstory\\history\\2026-02-17_17-20Z-linked-library-override-resync-issue.md",
"contextBefore": 0,
"contextAfter": 0,
"caseInsensitive": true
}
```
Additional data:
```json
{
"isPruned": true,
"pattern": "Step [0-9]|step [0-9]|get_pairs|orig.*rep|workflow",
"path": "a:\\1 Amazon_Active_Projects\\260206_PAE_2026\\.specstory\\history\\2026-02-17_17-20Z-linked-library-override-resync-issue.md",
"outputMode": "content",
"totalFiles": 1,
"totalMatches": 396,
"topFiles": [
{
"uri": "a:\\1 Amazon_Active_Projects\\260206_PAE_2026\\.specstory\\history\\2026-02-17_17-20Z-linked-library-override-resync-issue.md",
"matchCount": 60
}
]
}
```
Status: **completed**
---
Tool use: **read_file_v2** • Read file: T:\Dynamic-Link-Manager\operators.py
Tool use: **read_file_v2** • Read file: T:\Dynamic-Link-Manager\ui.py
Thought Process
I now have a good picture:
**Character migrator workflow (from spec):**
1. **Copy attributes** – Location, rotation, scale on armature object from original → replacement
2. **Migrate NLA** – Copy NLA tracks to replacement, matching blend_type (e.g. COMBINE)
3. **Custom properties** – Copy pose-bone custom props (exclude _RNA_UI, rigify_type, rigify_parameters)
4. **Bone constraints** – Copy to rep; skip when target == same orig; retarget when target == other character's orig → other's rep; first remove from rep any constraint targeting other's orig
5. **Retarget relations** – Parents, constraint targets, Armature modifiers, and any object targeting orig → point to rep
6. **Replacement base body** – Library override only (override_create(), no single-user copy), then assign shape-key action
7. **Remove duplicate constraints** – Trim rep constraints to match orig count
**Pair discovery:** In the spec they use hardcoded names (Hailey/Eddy, Steve, Una) and pattern like `BaseName_Rigify` (original) and `BaseName_Rigify.001` (replacement). So pairs are (orig_armature, rep_armature) where rep is typically in a collection like "Character.001" and has name "Character_Rigify.001". The workflow can be run for one or multiple character pairs; the code built a list of pairs and an orig→rep map for cross-character retargeting.
**Current add-on:** Dynamic Link Manager – focuses on scanning linked libraries, finding missing ones in folders, relinking, opening linked files. No character migration. The user wants to obsolete all of that and make the add-on centered on the character migrator workflow.
I'll create a plan that:
1. Summarizes the workflow from the spec (7 steps + rules)
2. Proposes replacing/overhauling the add-on to be "Character Migrator" or keep the name but make migration the primary feature
3. How to discover pairs (configurable or by convention: e.g. user selects orig + rep, or we scan for Name_Rigify / Name_Rigify.001)
4. UI: run full workflow, maybe run individual steps, select character pair(s)
5. What to remove (existing operators/UI that are obsolete) vs what to keep (e.g. search paths might still be useful if we ever need to link in assets – but user said "everything that came before is obsolete")
Let me check if there's more in the spec about how they want to "integrate" (e.g. UI, selection) and read a bit more of operators.py to list all current operators.
Tool use: **ripgrep_raw_search**
Parameters:
```json
{
"pattern": "bl_idname|def execute|class DLM_",
"path": "T:\\Dynamic-Link-Manager\\operators.py",
"caseInsensitive": false
}
```
Additional data:
```json
{
"isPruned": true,
"pattern": "bl_idname|def execute|class DLM_",
"path": "T:\\Dynamic-Link-Manager\\operators.py",
"outputMode": "content",
"totalFiles": 1,
"totalMatches": 36,
"topFiles": [
{
"uri": "operators.py",
"matchCount": 36
}
]
}
```
Status: **completed**
---
Tool use: **read_file_v2** • Read file: T:\Dynamic-Link-Manager\ui.py
Tool use: **read_file_v2** • Read file: a:\1 Amazon_Active_Projects\260206_PAE_2026\.specstory\history\2026-02-17_17-20Z-linked-library-override-resync-issue.md
Thought Process
I have a clear picture. The spec document is a long transcript; the canonical workflow is the 7-step process that was refined over many messages (Hailey/Eddy run at the end). Key details:
**Workflow steps (final form):**
1. Copy attributes (location, rotation, scale) on armature object from original → replacement
2. Migrate NLA (tracks + strips, blend_type, etc.) from original → replacement
3. Custom properties on pose bones (exclude _RNA_UI, rigify_type, rigify_parameters)
4. Bone constraints: skip target==orig; retarget target in orig_to_rep to rep; first remove from replacement any constraint that targets the other character's original
5. Retarget relations: parents, constraint targets, Armature modifiers, and any object targeting orig → rep
6. Replacement base body: library override only (override_create(), no copy), assign shape-key action
7. Remove duplicate constraints (trim rep to match orig count)
**Pair discovery:** Pairs are (base_name, orig_armature, rep_armature) where orig = e.g. `Name_Rigify`, rep = `Name_Rigify.001`. The code uses a hardcoded list of base names ('Hailey', 'Eddy') or ('Steve',) etc. For integration we need a way to get pairs - either user selection (two armatures) or scan by convention (find all Name_Rigify and Name_Rigify.001).
**Optional:** COPY_TRANSFORMS on control bones was sometimes skipped to make the replacement "independent" (so original can be purged). So that could be an option in the add-on.
Now I'll create the plan. The user said "everything that came before is obsolete" - so we're replacing the add-on's purpose with the character migrator. We could keep the add-on name "Dynamic Link Manager" and add the migrator as the main feature, or rename. I'll propose making the character migrator the core and either removing or demoting the old library-scan/relink features.
Tool use: **ripgrep_raw_search**
Parameters:
```json
{
"pattern": "get_pairs|pairs.*=.*\\[|base.*Rigify|orig.*rep",
"path": "a:\\1 Amazon_Active_Projects\\260206_PAE_2026\\.specstory\\history\\2026-02-17_17-20Z-linked-library-override-resync-issue.md",
"contextBefore": 0,
"contextAfter": 0,
"caseInsensitive": false
}
```
Additional data:
```json
{
"isPruned": true,
"pattern": "get_pairs|pairs.*=.*\\[|base.*Rigify|orig.*rep",
"path": "a:\\1 Amazon_Active_Projects\\260206_PAE_2026\\.specstory\\history\\2026-02-17_17-20Z-linked-library-override-resync-issue.md",
"outputMode": "content",
"totalFiles": 1,
"totalMatches": 233,
"topFiles": [
{
"uri": "a:\\1 Amazon_Active_Projects\\260206_PAE_2026\\.specstory\\history\\2026-02-17_17-20Z-linked-library-override-resync-issue.md",
"matchCount": 30
}
]
}
```
Status: **completed**
---
Thought Process
The workflow in the spec always uses explicit character base names (Hailey, Eddy, Steve, Una) and the convention `BaseName_Rigify` (original) and `BaseName_Rigify.001` (replacement). So for integration we need either:
- User-provided list of base names (e.g. from a preference or a text field), or
- User selects two armatures (original and replacement) and we run for that single pair, or
- Auto-detect: find all armatures named like *._Rigify and *._Rigify.001 and group by base name.
I'll include in the plan that pair discovery can be: (A) selection-based (two armatures = one pair), or (B) convention-based (scan for Name_Rigify / Name_Rigify.001), with optional configurable base names.
Creating the plan.
Tool use: **create_plan**
Parameters:
```json
{
"plan": "# Character Migrator Workflow Integration\n\n## Source of truth\n\nThe workflow is fully specified in the SpecStory transcript you referenced: [2026-02-17_17-20Z-linked-library-override-resync-issue.md](a:\\1 Amazon_Active_Projects\\260206_PAE_2026\\.specstory\\history\\2026-02-17_17-20Z-linked-library-override-resync-issue.md). The transcript evolves from a library resync issue into a repeatable **character replacement** flow for Rigify characters (Una, Steve, Eddy, Hailey). The final 7-step formulation appears in the Hailey/Eddy run (steps 1–7) and the subsequent fixes (no single-user copy for body; cross-character constraint retargeting; remove stale constraints on rep that target other’s original).\n\n## Workflow summary (7 steps)\n\n| Step | What it does |\n|------|----------------|\n| **1** | Copy armature object attributes: location, rotation (quaternion/euler), scale from original to replacement. |\n| **2** | Migrate NLA: copy tracks and strips to replacement, preserving `blend_type`, `extrapolation`, `frame_end`, `blend_in`/`blend_out`, `repeat`. Create `animation_data` on rep if missing. |\n| **3** | Custom properties: copy pose-bone custom props from original to replacement; exclude `_RNA_UI`, `rigify_type`, `rigify_parameters`. |\n| **4** | Bone constraints: (a) On replacement, remove any constraint whose target is another character’s *original* armature. (b) Copy constraints from original to replacement: skip if target is same character’s original; if target is another character’s original, set new constraint target to that character’s *replacement*; else keep target. Copy name, mute, influence, subtarget, and common props (e.g. head_tail, use_bone_object, invert_*). (c) Trim replacement bone constraints so count per bone matches original (remove from end). |\n| **5** | Retarget relations: (a) Rep’s descendants: parent to rep if was parent to orig; constraint targets and Armature modifier object pointing at orig → rep. (b) Any object in the file whose parent is orig → parent to rep; any constraint target or Armature modifier pointing at orig → rep. |\n| **6** | Replacement base body: for each replacement’s base body mesh (mesh with “body” and “base” in name, skinned to rep): if mesh data is linked or override, call `override_create()` only (no single-user copy). Then assign the matching shape-key action if found (e.g. `{body_name}Action`, `{mesh_data_name}Action`, `{body_name}Action.001`). |\n| **7** | Implemented inside step 4: remove duplicate constraints on replacement so each bone’s constraint count matches the original. |\n\n## Pair discovery\n\nIn the spec, pairs are **(base_name, orig_armature, rep_armature)** with naming like `Name_Rigify` (original) and `Name_Rigify.001` (replacement). For integration, support at least:\n\n- **Selection-based:** User selects two armatures (active = replacement, other selected = original) and runs the workflow for that single pair. No need to know “base name”.\n- **Optional: convention-based** – Scan for armatures named `*_Rigify` and `*_Rigify.001` (same base) to build multiple pairs; use a single “Run migration” that runs steps 1–7 for all discovered pairs with a shared `orig_to_rep` map for cross-character retargeting in step 4.\n\nHelper used everywhere: **descendants(armature)** = objects whose parent chain leads to that armature.\n\n## Current add-on vs new direction\n\n- **Current:** [operators.py](T:\\Dynamic-Link-Manager\\operators.py) and [ui.py](T:\\Dynamic-Link-Manager\\ui.py) implement linked library scanning, missing/indirect detection, search paths, find-in-folders relink, reload, open blend, path relative/absolute, relocate single library. [blender_manifest.toml](T:\\Dynamic-Link-Manager\\blender_manifest.toml) describes the add-on as “Relink characters and library blends with ease.”\n- **Direction:** Treat existing behaviour as obsolete. Make the add-on’s primary purpose the **character migrator**. Either remove the old operators/UI or move them behind a “Legacy” / “Library tools” sub-panel so the main panel is migrator-only.\n\n## Proposed architecture\n\n```mermaid\nflowchart LR\n subgraph ui [UI]\n Panel[Main Panel]\n RunAll[Run full migration]\n PairList[Pair list or selection]\n end\n subgraph core [Core]\n Discover[Discover pairs]\n Step1[Step 1: Copy attributes]\n Step2[Step 2: NLA]\n Step3[Step 3: Custom props]\n Step4[Step 4: Constraints]\n Step5[Step 5: Retarget relations]\n Step6[Step 6: Base body override]\n end\n Panel --> RunAll\n Panel --> PairList\n RunAll --> Discover\n Discover --> Step1 --> Step2 --> Step3 --> Step4 --> Step5 --> Step6\n```\n\n- **New module (recommended):** Add `migrator.py` (or `character_migrator.py`) containing:\n - `get_pairs_from_selection(context)` → list of (base_name, orig, rep) from two selected armatures (optional: orig/rep order by name or by “.001”).\n - `get_pairs_by_convention(context, base_names)` → list of pairs for given base names using `Name_Rigify` / `Name_Rigify.001`.\n - `run_step_1(orig, rep)` … `run_step_6(orig, rep, rep_descendants, orig_to_rep_map)` with signatures that match the spec (step 4 and 5 need `orig_to_rep` for all pairs in the batch).\n - One entry point: `run_full_migration(context, pairs)` that builds `orig_to_rep`, then for each pair gets `descendants(rep)` and runs steps 1–6 (with step 7 folded into step 4).\n- **Operators:** One operator, e.g. `DLM_OT_run_character_migration`, that (a) gets pairs from selection or from a convention/list, (b) calls `run_full_migration`. Optionally a “Run step N” operator for debugging.\n- **UI:** Main panel: “Character Migrator” section with “Run migration (selected armatures)” and, if implemented, “Run for all pairs” and a way to configure base names or list pairs. Remove or collapse current “Linked Libraries Analysis” into a secondary panel/section.\n\n## Important details from the spec\n\n- **No single-user copy for body:** Step 6 must use library override only (`override_create()`); do not do `ob.data = ob.data.copy()`.\n- **Cross-character constraints:** When copying a constraint to replacement A, if the constraint targets the *other* character’s original armature, set the new constraint’s target to that character’s replacement (and remove from the replacement any existing constraint that still targeted the other’s original).\n- **Base body detection:** Rep’s base body = mesh in `descendants(rep)` with `\"body\"` and `\"base\"` in name (case-insensitive) and Armature modifier pointing at rep.\n- **Shape-key action naming:** Try `{body_obj_name}Action`, `{mesh_data_name}Action`, `{body_obj_name}Action.001` (and similar variants if present in the spec).\n\n## Optional / future\n\n- **COPY_TRANSFORMS:** The spec sometimes added COPY_TRANSFORMS on control bones so rep follows orig in real time; other times it was omitted so the replacement stays independent (e.g. to purge original). Can be an add-on option (e.g. “Make replacement follow original”) later.\n- **Copy shape key values:** The spec also copies current shape key *values* from original body to replacement body in some runs; step 6 currently focuses on override + action. Copying values can be an extra step or option if you want parity with those runs.\n\n## Files to touch\n\n| File | Action |\n|------|--------|\n| New `migrator.py` | Add discovery helpers and step 1–6 (with 7 inside 4) from spec. |\n| [operators.py](T:\\Dynamic-Link-Manager\\operators.py) | Add `DLM_OT_run_character_migration` (and optionally per-step operators). Optionally remove or keep old operators. |\n| [ui.py](T:\\Dynamic-Link-Manager\\ui.py) | Replace or reorder main panel: Character Migrator primary; move linked-library UI to secondary or remove. Add any props for pair source (selection vs list). |\n| [__init__.py](T:\\Dynamic-Link-Manager\\__init__.py) | Import and register migrator operators (and migrator module if needed). |\n| [blender_manifest.toml](T:\\Dynamic-Link-Manager\\blender_manifest.toml) | Update description/tagline to reflect character migrator as main feature. |\n\n## Implementation order\n\n1. Add **migrator.py** with pure logic: `descendants()`, pair discovery (selection first), then `run_step_1` … `run_step_6` and `run_full_migration()` using the exact rules from the spec (including orig_to_rep for steps 4 and 5).\n2. Add **operator** that gets pairs (e.g. from selection: two armatures → one pair) and calls `run_full_migration()`; report errors and “Migrated N pairs” in the operator’s report.\n3. **UI:** One button “Run character migration” in the main panel (and short instructions: “Select original and replacement armatures”).\n4. **Clean-up:** Remove or demote old linked-library operators/UI; update manifest and __init__ as needed.\n5. (Optional) Add convention-based discovery and “Run for all” plus any options (e.g. COPY_TRANSFORMS, copy shape key values).\n\nThis keeps the spec’s workflow canonical and makes the add-on a thin UI + operator layer over a single, testable migrator core.\n",
"name": "Character Migrator Integration",
"overview": "Replace the current Dynamic Link Manager add-on (linked library scan/relink) with the character migrator workflow from the spec story: a 7-step process that migrates animation, constraints, relations, and base body from an \"original\" character armature to a \"replacement\" (e.g. linked/overridden) armature so the replacement can replace the original and the original can be purged."
}
```
Additional data:
```json
{
"reviewData": {
"status": "Requested",
"selectedOption": "none",
"isShowingInput": false
},
"planUri": "file:///c%3A/Users/Nathan/.cursor/plans/character_migrator_integration_cab95abc.plan.md",
"hasOpenedEditor": true
}
```
Result:
```json
{
"rejected": {}
}
```
Status: **completed**
---
_**User**_
Additions to the plan:
Keep everything for linked libraries analysis and put its boxes in their own dropdown underneath CharMig.
Discover pairs should have an automatic mode (already in the plan) and a manual mode where pairs are specified. Only one character should be migrated at a time. The migrator should have 2 fields. First should be the original character, second should be for the replacement character. These fields should have picker buttons that populate the field with the active armature when clicked. Many of the operators will need to manipulate datablocks other than the armature, so they should be able to view the linked collection that the armature is a part of in order to do so cleanly.
Our project should mirror the structure of this extension: T:\AmazonCharacterTools
---
_**Agent (model default, mode Agent)**_
Thought Process
The user wants to update the plan with several additions:
1. **Linked libraries:** Keep everything for linked libraries analysis and put its boxes in their own dropdown underneath "CharMig" (Character Migrator). So the main panel has CharMig first, then a collapsible section for linked libraries.
2. **Pair discovery:**
- Automatic mode (already in plan)
- Manual mode where pairs are specified
- Only one character migrated at a time (not batch)
3. **Migrator UI:**
- Two fields: "Original character" and "Replacement character"
- Picker buttons that populate the field with the active armature when clicked
- So it's manual selection via two fields + picker, not "select two objects and run"
4. **Operators need to manipulate other datablocks:** They should be able to "view" the linked collection that the armature is part of - meaning when working with a linked/overridden armature, we need to consider the collection context (e.g. to find descendants, base body meshes that belong to that character). So the logic needs to work with the collection that contains the armature, not just the armature in isolation.
5. **Project structure:** Mirror the structure of T:\AmazonCharacterTools. I need to look at that project's structure to understand what to mirror.
Let me read the AmazonCharacterTools structure first, then update the plan file.
Tool use: **glob_file_search** • Searched codebase "undefined" • **107** results in **1** directory
Directory: **T:\AmazonCharacterTools** (107 files)
| File |
|------|
| `../..\AmazonCharacterTools\.git\FETCH_HEAD` |
| `../..\AmazonCharacterTools\.git\ORIG_HEAD` |
| `../..\AmazonCharacterTools\.git\refs\tags\v0.10.1` |
| `../..\AmazonCharacterTools\.git\logs\refs\remotes\origin\main` |
| `../..\AmazonCharacterTools\.git\refs\remotes\origin\main` |
| `../..\AmazonCharacterTools\.git\lfs\cache\locks\refs\heads\main\verifiable` |
| `../..\AmazonCharacterTools\.git\logs\refs\heads\main` |
| `../..\AmazonCharacterTools\.git\logs\HEAD` |
| `../..\AmazonCharacterTools\.git\refs\heads\main` |
| `../..\AmazonCharacterTools\.git\COMMIT_EDITMSG` |
| `../..\AmazonCharacterTools\.specstory\.what-is-this.md` |
| `../..\AmazonCharacterTools\.git\objects\49\9172bfb69fc27226e73bc1bc82c18d1ebebb0e` |
| `../..\AmazonCharacterTools\changelog.md` |
| `../..\AmazonCharacterTools\blender_manifest.toml` |
| `../..\AmazonCharacterTools\.git\objects\a5\ed1c1c66223a4598c16810901ab953758deb0f` |
| `../..\AmazonCharacterTools\ui\operators.py` |
| `../..\AmazonCharacterTools\.specstory\history\2026-01-01_23-46Z-blender-5-0-api-bone-selection-issue.md` |
| `../..\AmazonCharacterTools\.git\logs\refs\remotes\origin\HEAD` |
| `../..\AmazonCharacterTools\.git\refs\remotes\origin\HEAD` |
| `../..\AmazonCharacterTools\.git\refs\tags\v0.10.0` |
| `../..\AmazonCharacterTools\.git\objects\b0\df997989d6703d78f087274d4f48abed9ab80b` |
| `../..\AmazonCharacterTools\.git\objects\a5\2be7a4fdecd2deff0fd8c9a23eae0516bd2d8e` |
| `../..\AmazonCharacterTools\ops\__init__.py` |
| `../..\AmazonCharacterTools\ops\Devices_FreshPlacement.py` |
| `../..\AmazonCharacterTools\ops\Device_Replacement.py` |
| `../..\AmazonCharacterTools\ops\hh_spawn.py` |
| `../..\AmazonCharacterTools\ops\replace_cel_with_bsdf.py` |
| `../..\AmazonCharacterTools\ops\remap_vector_fonts.py` |
| `../..\AmazonCharacterTools\.git\objects\08\81792fcc238860360c31fa3bbfd24aa3bd7ade` |
| `../..\AmazonCharacterTools\.git\objects\db\c3cebed267593b741981370b58bba5986a74d0` |
| `../..\AmazonCharacterTools\.git\objects\info\commit-graphs\commit-graph-chain` |
| `../..\AmazonCharacterTools\.git\objects\61\0ef9e5b54b0cf816ae1681c80b9980c73f689e` |
| `../..\AmazonCharacterTools\.git\objects\6f\968d6a99a8d6bf29996e9c944f9b25107534c7` |
| `../..\AmazonCharacterTools\utils\__init__.py` |
| `../..\AmazonCharacterTools\.git\objects\cd\581b5fe0d145990eeda4b7c2b0aacf9f3a09f1` |
| `../..\AmazonCharacterTools\.git\objects\f5\63a3de20e5f361c55d2cebfe650ee01d22e020` |
| `../..\AmazonCharacterTools\__init__.py` |
| `../..\AmazonCharacterTools\ui\preferences.py` |
| `../..\AmazonCharacterTools\.git\objects\99\405af39eb1a87d4a7215900a17007db0366248` |
| `../..\AmazonCharacterTools\.specstory\history\2026-01-12_23-06Z-powershell-c++-build-tools-necessity.md` |
| `../..\AmazonCharacterTools\ui\__init__.py` |
| `../..\AmazonCharacterTools\ops\SettingsBone.py` |
| `../..\AmazonCharacterTools\.git\objects\05\0caf96ff58b977eefe5cd790d13d0af291311e` |
| `../..\AmazonCharacterTools\.git\refs\tags\v0.9.1` |
| `../..\AmazonCharacterTools\.git\objects\49\02858db98ad72e5ace4ff886b114e8a4e52522` |
| `../..\AmazonCharacterTools\.git\objects\8c\f1c0de414c5dfc33d06e6d644fe00099562e1a` |
| `../..\AmazonCharacterTools\.git\objects\61\45befea944edbed776e65a0311e175a2e2b99b` |
| `../..\AmazonCharacterTools\.specstory\history\2025-10-16_22-09Z-port-addon-to-standard-blender-format.md` |
| `../..\AmazonCharacterTools\.specstory\history\2025-12-23_21-00Z-ssd-crash-log-explanation.md` |
| `../..\AmazonCharacterTools\.git\objects\e2\d202e7e2f7f227479f72ed2e3689f1a1f200bb` |
| `../..\AmazonCharacterTools\.git\refs\tags\v0.9.0` |
| `../..\AmazonCharacterTools\.git\refs\tags\v0.8.0` |
| `../..\AmazonCharacterTools\ui\panels.py` |
| `../..\AmazonCharacterTools\.git\cursor\crepe\085b3f349bd61101198bebff24f48ad5c5c9a494\metadata.json` |
| `../..\AmazonCharacterTools\.git\refs\tags\v0.7.0` |
| `../..\AmazonCharacterTools\.gitea\workflows\release.yml` |
| `../..\AmazonCharacterTools\.gitea\docker-compose.runner.yml` |
| `../..\AmazonCharacterTools\.git\HEAD` |
| `../..\AmazonCharacterTools\.gitignore` |
| `../..\AmazonCharacterTools\.specstory\history\2025-10-14_22-09Z-adding-new-features-to-blender-tools.md` |
| `../..\AmazonCharacterTools\.specstory\history\2025-08-15_17-39Z-fix-viewport-visibility-error-in-blender.md` |
| `../..\AmazonCharacterTools\.git\config` |
| `../..\AmazonCharacterTools\.gitattributes` |
| `../..\AmazonCharacterTools\.git\hooks\post-commit` |
| `../..\AmazonCharacterTools\.git\hooks\post-merge` |
| `../..\AmazonCharacterTools\.git\hooks\post-checkout` |
| `../..\AmazonCharacterTools\.git\hooks\pre-push` |
| `../..\AmazonCharacterTools\.specstory\.gitignore` |
| `../..\AmazonCharacterTools\.specstory\.project.json` |
| `../..\AmazonCharacterTools\ops\hh_mask.py` |
| `../..\AmazonCharacterTools\ops\hh_settings.py` |
| `../..\AmazonCharacterTools\ops\MaskSettings.py` |
| `../..\AmazonCharacterTools\ops\hh_shapekey.py` |
| `../..\AmazonCharacterTools\ops\hh_set_targets.py` |
| `../..\AmazonCharacterTools\ops\apply_subdiv_wgt.py` |
| `../..\AmazonCharacterTools\ops\BodyMasker.py` |
| `../..\AmazonCharacterTools\ops\DevicesSettings.py` |
| `../..\AmazonCharacterTools\ops\custom_vis.py` |
| `../..\AmazonCharacterTools\ops\GeoSeparator.py` |
| `../..\AmazonCharacterTools\.git\cursor_metadata.pb` |
| `../..\AmazonCharacterTools\.git\packed-refs` |
| `../..\AmazonCharacterTools\.specstory\history\2025-07-03_19-28Z-create-geoseparator-script-for-organization.md` |
| `../..\AmazonCharacterTools\.specstory\history\2025-07-18_16-47Z-add-debug-to-serpens-addon-script.md` |
| `../..\AmazonCharacterTools\.specstory\history\2025-08-05_15-41Z-@custom-vis-py-why-the-traceback.md` |
| `../..\AmazonCharacterTools\.specstory\history\2025-07-01_22-15Z-troubleshooting-blender-operator-error.md` |
| `../..\AmazonCharacterTools\.specstory\history\2025-07-02_19-54Z-blender-keymap-and-save-settings-issue.md` |
| `../..\AmazonCharacterTools\.specstory\history\2025-07-02_16-34Z-adding-bone-widget-in-pose-mode.md` |
| `../..\AmazonCharacterTools\.specstory\history\2025-07-02_21-55Z-delete-and-create-blender-world.md` |
| `../..\AmazonCharacterTools\.specstory\history\2025-07-03_18-01Z-update-device-script-functionality.md` |
| `../..\AmazonCharacterTools\.specstory\history\2025-07-03_16-24Z-get-scale-from-original-device-object.md` |
| `../..\AmazonCharacterTools\.cursorindexingignore` |
| `../..\AmazonCharacterTools\.git\info\exclude` |
| `../..\AmazonCharacterTools\.git\hooks\update.sample` |
| `../..\AmazonCharacterTools\.git\hooks\pre-merge-commit.sample` |
| `../..\AmazonCharacterTools\.git\hooks\pre-commit.sample` |
| `../..\AmazonCharacterTools\.git\hooks\pre-push.sample` |
| `../..\AmazonCharacterTools\.git\hooks\pre-receive.sample` |
| `../..\AmazonCharacterTools\.git\hooks\pre-rebase.sample` |
| `../..\AmazonCharacterTools\.git\hooks\prepare-commit-msg.sample` |
| `../..\AmazonCharacterTools\.git\hooks\push-to-checkout.sample` |
| `../..\AmazonCharacterTools\.git\hooks\sendemail-validate.sample` |
| `../..\AmazonCharacterTools\.git\hooks\fsmonitor-watchman.sample` |
| `../..\AmazonCharacterTools\.git\hooks\post-update.sample` |
| `../..\AmazonCharacterTools\.git\hooks\pre-applypatch.sample` |
| `../..\AmazonCharacterTools\.git\description` |
| `../..\AmazonCharacterTools\.git\hooks\applypatch-msg.sample` |
| `../..\AmazonCharacterTools\.git\hooks\commit-msg.sample` |
---
Tool use: **read_file_v2** • Read file: c:\Users\Nathan\.cursor\plans\character_migrator_integration_cab95abc.plan.md
Thought Process
I need to see the actual folder structure of AmazonCharacterTools (excluding .git and .specstory) to mirror it. Let me list the top-level and key subdirs.
Tool use: **read_file_v2** • Read file: T:\AmazonCharacterTools\__init__.py
Tool use: **read_file_v2** • Read file: T:\AmazonCharacterTools\ui\__init__.py
Tool use: **read_file_v2** • Read file: T:\AmazonCharacterTools\ops\__init__.py
Thought Process
Let me get the full structure - list_dir didn't work, I'll use list_dir on the path. Actually the glob already showed the structure. Key dirs:
- T:\AmazonCharacterTools\
- __init__.py (main entry)
- blender_manifest.toml
- ui/
- __init__.py (exports OPERATOR_CLASSES, PANEL_CLASSES, AMZN_AddonPreferences)
- operators.py
- panels.py
- preferences.py
- ops/
- __init__.py (empty / just docstring)
- Various op files: Devices_FreshPlacement.py, Device_Replacement.py, etc.
- utils/
- __init__.py
So the structure is:
- Root: __init__.py, blender_manifest.toml
- ui/: operators (UI-related?), panels, preferences; __init__ aggregates CLASSES
- ops/: one file per feature (operators)
- utils/: helpers
I need to see how ops are registered - does __init__.py in root import from ops?
Tool use: **read_file_v2** • Read file: T:\AmazonCharacterTools\ui\panels.py
Tool use: **read_file_v2** • Read file: T:\AmazonCharacterTools\ui\operators.py
Tool use: **ripgrep_raw_search**
Parameters:
```json
{
"pattern": "from \\.ops|import.*ops|OPERATOR",
"path": "T:\\AmazonCharacterTools",
"glob": "*.py",
"caseInsensitive": false
}
```
Additional data:
```json
{
"isPruned": true,
"pattern": "from \\.ops|import.*ops|OPERATOR",
"path": "T:\\AmazonCharacterTools",
"outputMode": "content",
"totalFiles": 3,
"totalMatches": 5,
"topFiles": [
{
"uri": "..\\AmazonCharacterTools\\ui\\operators.py",
"matchCount": 1
},
{
"uri": "..\\AmazonCharacterTools\\__init__.py",
"matchCount": 2
},
{
"uri": "..\\AmazonCharacterTools\\ui\\__init__.py",
"matchCount": 2
}
]
}
```
Status: **completed**
---
Thought Process
So AmazonCharacterTools structure:
- **Root** `__init__.py`: imports from `.ui` only (OPERATOR_CLASSES, PANEL_CLASSES, AMZN_AddonPreferences), registers all.
- **ui/**: `__init__.py` exports OPERATOR_CLASSES, PANEL_CLASSES, AMZN_AddonPreferences.
- `operators.py`: defines OP_SPECS (list of dicts: name, id, script, button, icon, panel); OPS_DIR = parent/ops; OPERATOR_CLASSES = dynamic operators that run scripts from ops/.
- `panels.py`: defines panels that reference OP_SPECS; PANEL_CLASSES.
- `preferences.py`: AMZN_AddonPreferences.
- **ops/**: standalone Python scripts (e.g. SettingsBone.py) that get run via runpy from ui/operators.py. Each op is a spec that points to a script.
So for Dynamic-Link-Manager we need to mirror:
- **Root**: `__init__.py`, `blender_manifest.toml`
- **ui/**: `__init__.py`, `operators.py` (or keep operators that are UI-triggered here), `panels.py`, `preferences.py`
- **ops/**: one module per feature; for DLM we have (1) all the current library ops and (2) character migrator. So we could have ops/migrator.py or ops/character_migrator.py and ops/library_*.py or keep library in one file.
- **utils/**: shared helpers (e.g. descendants, path resolution)
The user said "mirror the structure" - so we need:
- DLM root: __init__.py, blender_manifest.toml
- ui/ with __init__, operators, panels, preferences
- ops/ with migrator logic (and maybe library ops split out)
- utils/ for helpers
Now update the plan with all additions:
1. **Linked libraries:** Keep everything; put in their own dropdown underneath CharMig.
2. **Pair discovery:** Automatic mode + Manual mode. Only one character at a time (single pair).
3. **Manual mode UI:** Two fields - "Original character", "Replacement character". Picker buttons that set the field to the active armature's name (or reference).
4. **Collection context:** Operators need to be able to "view" the linked collection the armature is part of so they can manipulate other datablocks (descendants, meshes) cleanly. So we need to resolve "the collection that contains this armature" (e.g. the root collection of that character - often the armature's users_collection or the collection that has the same base name).
5. **Project structure:** Mirror AmazonCharacterTools: ui/, ops/, utils/, root __init__.py.
I'll update the plan file with these additions and the new structure.
Tool use: **read_file_v2** • Read file: T:\AmazonCharacterTools\ui\preferences.py
Tool use: **ripgrep_raw_search**
Parameters:
```json
{
"pattern": "bpy\\.types\\.(Scene|Object)\\.",
"path": "T:\\Dynamic-Link-Manager",
"caseInsensitive": false
}
```
Additional data:
```json
{
"isPruned": true,
"pattern": "bpy\\.types\\.(Scene|Object)\\.",
"path": "T:\\Dynamic-Link-Manager",
"outputMode": "content",
"totalFiles": 3,
"totalMatches": 10,
"topFiles": [
{
"uri": ".specstory\\history\\2025-08-20_22-43Z-creating-a-blender-extension-for-asset-replacement.md",
"matchCount": 4
},
{
"uri": ".specstory/history/2025-08-20_22-43Z-creating-a-blender-extension-for-asset-replacement.md",
"matchCount": 4
},
{
"uri": "ui.py",
"matchCount": 2
}
]
}
```
Status: **completed**
---
Thought Process
I have enough. Updating the plan with:
1. Linked libraries: keep everything, own dropdown underneath CharMig.
2. Pair discovery: automatic (convention) + manual. Only one character at a time (single pair).
3. Manual UI: two fields (original character, replacement character) + picker buttons that set from active armature.
4. Collection context: migrator/operators should resolve the linked collection that the armature belongs to so they can work with descendants/other datablocks cleanly.
5. Project structure: mirror AmazonCharacterTools → ui/, ops/, utils/, root __init__.py; ops/ for migrator (and library) logic; ui/ for panels, operators (that invoke ops), preferences.
Writing the plan update.
Tool use: **edit_file_v2** • Edit file: c:\Users\Nathan\.cursor\plans\character_migrator_integration_cab95abc.plan.md
Thought Process
Now update the architecture section to reflect: (1) project structure mirroring AmazonCharacterTools, (2) manual vs automatic mode, (3) two fields + pickers, (4) collection context.
Tool use: **edit_file_v2** • Edit file: c:\Users\Nathan\.cursor\plans\character_migrator_integration_cab95abc.plan.md
Thought Process
Now update the "Files to touch" and "Implementation order" sections to reflect the new structure (ui/, ops/, utils/) and the additions (linked libs kept in dropdown, manual/auto, pickers, collection context).
Thought Process
The table has different formatting (extra spaces). Let me try replacing just the "## Files to touch" section through the end of implementation order in smaller chunks.
Tool use: **read_file_v2** • Read file: c:\Users\Nathan\.cursor\plans\character_migrator_integration_cab95abc.plan.md
Thought Process
I see - the table uses | with spaces. Let me do the replace in one go with the exact content.
Thought Process
The issue might be with the pipe characters in the table or some encoding. Let me try replacing just the "## Files to touch" header and the table and implementation order in two smaller replacements. First replace from "## Files to touch" through the table (up to and including the blank line before "## Implementation order").
Tool use: **edit_file_v2** • Edit file: c:\Users\Nathan\.cursor\plans\character_migrator_integration_cab95abc.plan.md
Thought Process
Good, that worked. Now replace the implementation order section.
Thought Process
The quotes might be different - curly vs straight. Let me try with the exact curly quotes from the fuzzy match.
Thought Process
The fuzzy match shows straight quotes in the file. Let me read the file again to get the exact bytes.
Tool use: **read_file_v2** • Read file: c:\Users\Nathan\.cursor\plans\character_migrator_integration_cab95abc.plan.md
Thought Process
I see - line 116 shows "Root init.py" - the ** got converted. And the quotes in the file might be Unicode curly quotes. Let me try copying exactly from the read_file output - the quotes look like standard ASCII in the display. I'll try replacing line by line or use a shorter unique string.
Tool use: **edit_file_v2** • Edit file: c:\Users\Nathan\.cursor\plans\character_migrator_integration_cab95abc.plan.md
Thought Process
That created a mess - I left the old step 1 in. Let me remove the old implementation steps and the "(Removed old step 1.)" and fix the numbering.
Thought Process
The file has curly quotes. Let me try with the exact characters - I'll try replacing just the erroneous line and the following old items.
Tool use: **edit_file_v2** • Edit file: c:\Users\Nathan\.cursor\plans\character_migrator_integration_cab95abc.plan.md
Thought Process
That's still wrong - I'm leaving duplicate/orphan content. Let me read the file and do one clean replacement to remove the leftover old steps and fix the closing sentence.
Tool use: **read_file_v2** • Read file: c:\Users\Nathan\.cursor\plans\character_migrator_integration_cab95abc.plan.md
Thought Process
I see - my replacement left "7. (Reserved.)" but the rest of the old step 1 was merged so now we have "7. (Reserved.) `descendants()`, pair discovery..." and then old steps 2-5 became 8-11. I need to remove lines 127-134 (the duplicate old steps and the old closing sentence) and change "7. (Reserved.)" to just the closing sentence.
Thought Process
The fuzzy match shows curly double quotes in the file (""). Let me try using grep to get the exact content and then do a run_terminal_cmd to do the replacement with sed or just do multiple small search_replace operations. Actually, let me try replace_all with a simpler pattern - replace line 7 onwards.
Tool use: **edit_file_v2** • Edit file: c:\Users\Nathan\.cursor\plans\character_migrator_integration_cab95abc.plan.md
Thought Process
Let me try to remove from " `descendants()" through the end of the paragraph in chunks. First remove the tail of line 127.
Tool use: **edit_file_v2** • Edit file: c:\Users\Nathan\.cursor\plans\character_migrator_integration_cab95abc.plan.md
Thought Process
Now remove lines 8-11 and replace with the closing sentence. Let me read the file again to get exact content.
Thought Process
Let me read the current state of the file again.
Tool use: **read_file_v2** • Read file: c:\Users\Nathan\.cursor\plans\character_migrator_integration_cab95abc.plan.md
Thought Process
So the "7." was replaced with empty, and now we have a blank line then "2. Add **operator**" - the numbering got broken (old steps 2-5 without the "8." "9." etc). I need to delete from line 128 (blank) through 134 and replace the closing sentence with the new one.
Thought Process
The quotes in the file are definitely curly. Let me try writing the exact bytes - in the fuzzy match they show as " and ". I'll try copying from the fuzzy match output character by character. Actually, the simplest approach: use run_terminal_cmd to run a small Python or PowerShell script that does the replacement, or use a single-line search that's unique. Let me try replacing just "2. Add **operator**" with nothing and see if that's the right encoding - then do the rest in separate steps. Actually, I'll try with the curly quote character. In Unicode, the right double quote is U+201D. Let me try escaping or using a different approach - replace the closing sentence only first.
Tool use: **ripgrep_raw_search**
Parameters:
```json
{
"pattern": "Migrated N pairs|canonical and makes",
"path": "c:\\Users\\Nathan\\.cursor\\plans\\character_migrator_integration_cab95abc.plan.md",
"caseInsensitive": false
}
```
Additional data:
```json
{
"isPruned": true,
"pattern": "Migrated N pairs|canonical and makes",
"path": "c:\\Users\\Nathan\\.cursor\\plans\\character_migrator_integration_cab95abc.plan.md",
"outputMode": "content",
"totalFiles": 1,
"totalMatches": 2,
"topFiles": [
{
"uri": "c:\\Users\\Nathan\\.cursor\\plans\\character_migrator_integration_cab95abc.plan.md",
"matchCount": 2
}
]
}
```
Status: **completed**
---
Thought Process
So the file does have the content. The issue is my search string uses straight quotes and the file has curly quotes. Let me try using run_terminal_cmd to replace. Actually, the run_terminal_cmd might have encoding issues too. Let me try search_replace with the Unicode curly quotes. In Python the right double quote is "\u201c" for left and "\u201d" for right. So "operator's" would be: " and '. Let me try replacing a smaller unique string that might be ascii - like "run_full_migration()" which is ascii.
Thought Process
So the fuzzy match is not even that line - it's matching something else. The search_replace might be normalizing quotes. Let me try reading the raw file with a different approach - maybe the plan file is in the workspace. Let me try writing a small patch: read the full file, then write the full file with the duplicate block removed.
Tool use: **read_file_v2** • Read file: c:\Users\Nathan\.cursor\plans\character_migrator_integration_cab95abc.plan.md
Thought Process
I see - when I read the file, the quotes display as straight in the read_file output. So the file might have straight quotes. Let me try the replace again with the exact characters from the read - lines 128-134. I notice line 128 is blank and line 129 starts with "2. Add" - so there's no "7." in the current file. Let me try replacing the block from the blank line after step 6 through the end.
Tool use: **edit_file_v2** • Edit file: c:\Users\Nathan\.cursor\plans\character_migrator_integration_cab95abc.plan.md
Thought Process
Now I need to remove the "(Removed duplicate) 2. Add **operator**" through the end of the old closing sentence.
Thought Process
The file might have different quote characters. Let me try deleting line by line. First delete "(Removed duplicate) 2. Add **operator**"
Tool use: **read_file_v2** • Read file: c:\Users\Nathan\.cursor\plans\character_migrator_integration_cab95abc.plan.md
Thought Process
So we have the correct closing paragraph already at 128-129. I just need to remove lines 130-134. The read_file shows straight apostrophe in "spec's" and "operator's" - so maybe the issue is the double-quote character. Let me try replacing only the first line of the duplicate block to see - maybe the " and " are Unicode. I'll try using run_terminal_cmd with Python to do the replacement.
Tool use: **run_terminal_command_v2** • Run command: python -c "
path = r'c:\Users\Nathan\.cursor\plans\character_migrator_integration_cab95abc.plan.md'
with open(path, 'r', encoding='utf-8') as f:
text = f.read()
old = '''(Removed duplicate) 2. Add **operator** that gets pairs (e.g. from selection: two armatures → one pair) and calls `run_full_migration()`; report errors and \"Migrated N pairs\" in the operator's report.
3. **UI:** One button \"Run character migration\" in the main panel (and short instructions: \"Select original and replacement armatures\").
4. **Clean-up:** Remove or demote old linked-library operators/UI; update manifest and **init** as needed.
5. (Optional) Add convention-based discovery and \"Run for all\" plus any options (e.g. COPY_TRANSFORMS, copy shape key values).
This keeps the spec's workflow canonical and makes the add-on a thin UI + operator layer over a single, testable migrator core.'''
if old in text:
text = text.replace(old, '')
with open(path, 'w', encoding='utf-8') as f:
f.write(text)
print('Replaced successfully')
else:
print('Old string not found')
print('First 200 chars of what we look for:', repr(old[:200]))
"
```bash
python -c "
path = r'c:\Users\Nathan\.cursor\plans\character_migrator_integration_cab95abc.plan.md'
with open(path, 'r', encoding='utf-8') as f:
text = f.read()
old = '''(Removed duplicate) 2. Add **operator** that gets pairs (e.g. from selection: two armatures → one pair) and calls `run_full_migration()`; report errors and \"Migrated N pairs\" in the operator's report.
3. **UI:** One button \"Run character migration\" in the main panel (and short instructions: \"Select original and replacement armatures\").
4. **Clean-up:** Remove or demote old linked-library operators/UI; update manifest and **init** as needed.
5. (Optional) Add convention-based discovery and \"Run for all\" plus any options (e.g. COPY_TRANSFORMS, copy shape key values).
This keeps the spec's workflow canonical and makes the add-on a thin UI + operator layer over a single, testable migrator core.'''
if old in text:
text = text.replace(old, '')
with open(path, 'w', encoding='utf-8') as f:
f.write(text)
print('Replaced successfully')
else:
print('Old string not found')
print('First 200 chars of what we look for:', repr(old[:200]))
"
```
```
File "<string>", line 5
old = '''(Removed duplicate) 2. Add **operator** that gets pairs (e.g. from selection: two armatures \u2192 one pair) and calls
^
SyntaxError: unterminated triple-quoted string literal (detected at line 6)
```
Thought Process
The triple quote is conflicting. Let me read the file from Python and do the replacement with a simpler approach - read lines and write back lines 1-129 only.
Tool use: **run_terminal_command_v2** • Run command: python -c "
path = r'c:\Users\Nathan\.cursor\plans\character_migrator_integration_cab95abc.plan.md'
with open(path, 'r', encoding='utf-8') as f:
lines = f.readlines()
# Keep lines 1-129 (0-indexed: 0-128)
with open(path, 'w', encoding='utf-8') as f:
f.writelines(lines[:129])
print('Trimmed to 129 lines')
"
```bash
python -c "
path = r'c:\Users\Nathan\.cursor\plans\character_migrator_integration_cab95abc.plan.md'
with open(path, 'r', encoding='utf-8') as f:
lines = f.readlines()
# Keep lines 1-129 (0-indexed: 0-128)
with open(path, 'w', encoding='utf-8') as f:
f.writelines(lines[:129])
print('Trimmed to 129 lines')
"
```
```
Trimmed to 129 lines
```
Thought Process
Good. Now fix the typo in the plan: "Root init.py" should be "Root __init__.py" on line 116.
Tool use: **edit_file_v2** • Edit file: c:\Users\Nathan\.cursor\plans\character_migrator_integration_cab95abc.plan.md
Thought Process
Also fix the link in the plan - line 44 shows "T:AmazonCharacterTools" (single backslash eaten). Let me check - the plan said "Mirror the layout of [T:AmazonCharacterTools](T:\AmazonCharacterTools):" - the link might have been corrupted. Let me read that line.
Tool use: **ripgrep_raw_search**
Parameters:
```json
{
"pattern": "AmazonCharacterTools",
"path": "c:\\Users\\Nathan\\.cursor\\plans\\character_migrator_integration_cab95abc.plan.md",
"caseInsensitive": false
}
```
Additional data:
```json
{
"isPruned": true,
"pattern": "AmazonCharacterTools",
"path": "c:\\Users\\Nathan\\.cursor\\plans\\character_migrator_integration_cab95abc.plan.md",
"outputMode": "content",
"totalFiles": 1,
"totalMatches": 3,
"topFiles": [
{
"uri": "c:\\Users\\Nathan\\.cursor\\plans\\character_migrator_integration_cab95abc.plan.md",
"matchCount": 3
}
]
}
```
Status: **completed**
---
Thought Process
The link shows as (T:\AmazonCharacterTools) - in markdown the backslash might need to be escaped. It's fine for display. The plan is updated. Let me give the user a summary of what was added.
Thought Process
The user wants me to implement the Character Migrator Workflow Integration plan. Let me first check what todos exist and then work through them in order.
I'll need to:
1. Find the existing todos
2. Restructure the project (ui/, ops/, utils/) - move existing code
3. Add utils (descendants, collection helper)
4. Implement ops/migrator.py
5. Add migrator props and operators
6. UI: CharMig section + Linked Libraries dropdown
7. Update manifest and __init__
Let me start by listing the project structure and finding the todos.
Tool use: **todo_write** • Todo List
- [-] Restructure: create ui/, ops/, utils/; move existing code
- [ ] utils: descendants() and collection-containing-armature helper
- [ ] ops/migrator.py: steps 1-6, get_pair_manual/automatic, run_full_migration
- [ ] Migrator props and operators (run migration, pickers)
- [ ] UI: CharMig section + Linked Libraries dropdown
- [ ] Update blender_manifest.toml and __init__ registration
Tool use: **read_file_v2** • Read file: T:\Dynamic-Link-Manager\__init__.py
Tool use: **read_file_v2** • Read file: T:\Dynamic-Link-Manager\ui.py
Tool use: **read_file_v2** • Read file: T:\Dynamic-Link-Manager\operators.py
Thought Process
I need to read the rest of operators.py to get all operators and understand the full register() list. Then I'll create the folder structure:
- ui/ with operators.py, panels.py, preferences.py, __init__.py
- ops/ with library logic (scan, find, etc.) and later migrator
- utils/ with __init__.py
The plan says to move "existing panel/operator/prefs and library logic" into ui/ and ops/. So:
- ui/panels.py: panel classes (split from current ui.py), and the panel draw logic
- ui/preferences.py: DynamicLinkManagerPreferences, SearchPathItem (from ui.py)
- ui/operators.py: all DLM operators - both library and (later) migrator. The library operators can stay as operators that call into ops if we put the heavy logic in ops, or we can keep the logic in ui/operators for now and just move the file.
- ops/: put the scan logic in ops/library.py or similar so ui/operators just invokes it. Actually re-reading the plan: "Library: move current library-scan/relink logic into ops/ (e.g. one or more modules) and have ui/operators call into them." So I'll have ops/library.py with the scan/find/relink logic, and ui/operators will define the Operator classes that call into ops.library.
Let me read the full operators.py to see register() and all operator classes.
Tool use: **read_file_v2** • Read file: T:\Dynamic-Link-Manager\operators.py
Tool use: **ripgrep_raw_search**
Parameters:
```json
{
"pattern": "^class |^def register|^def unregister",
"path": "T:\\Dynamic-Link-Manager\\operators.py",
"caseInsensitive": false
}
```
Additional data:
```json
{
"isPruned": true,
"pattern": "^class |^def register|^def unregister",
"path": "T:\\Dynamic-Link-Manager\\operators.py",
"outputMode": "content",
"totalFiles": 1,
"totalMatches": 15,
"topFiles": [
{
"uri": "operators.py",
"matchCount": 15
}
]
}
```
Status: **completed**
---
Thought Process
There are two register() blocks in operators.py - the first one at 392 only registers 2 classes, then more classes are defined, and the second register() at 702 registers all. So the first register() (lines 392-394) is dead code. I'll create the new structure:
1. utils/__init__.py - empty for now (will add descendants and collection helper in todo 2)
2. ops/__init__.py - empty
3. ops/library.py - I'll keep library logic in ui/operators for simplicity and fewer changes; the plan says "move current library-scan/relink logic into ops/" - I could either move the execute() bodies into ops.library and have operators call them, or keep operators as-is in ui/operators. To minimize breakage I'll keep the operator classes in ui/operators and not split the library logic into ops for now - we can do that refactor later. Actually the plan says "Library: move or re-export existing library operators here (or keep in ops and call from here)". So the operators stay in ui/operators, and we can put the heavy scan logic in ops/library.py. For the restructure, the minimal move is: create ui/, ops/, utils/, move the current ui.py content into ui/ (split into panels.py, preferences.py, and property groups/UIList can stay in panels or a separate file), move operators.py to ui/operators.py, then root __init__.py imports from .ui and registers. That way we don't have to split the library logic yet - we just reorganize files. Let me do that.
Actually re-reading again: "Create ui/, ops/, utils/; move existing panel/operator/prefs and library logic into ui/ and ops/". So:
- ui/ gets: panels, preferences, operators (all the current UI and operator classes)
- ops/ gets: library logic - the plan says "move current library-scan/relink logic into ops/". So the scan_linked_assets execute() logic could go to ops/library.py scan_linked_assets(context) and the operator just calls it. Same for find_libraries_in_folders. That would make the code cleaner. Let me do the file move first without splitting the library logic (so ops/ can be empty except __init__.py), then add utils, then add migrator. We can optionally move library logic to ops in a later step. The implementation order says "move existing panel/operator/prefs and library logic into ui/ and ops/" - so I'll put the library scan/find logic into ops/library.py.
Let me create:
1. utils/__init__.py (empty for now)
2. ops/__init__.py (empty)
3. ops/library.py - with scan and find_libraries logic (extracted from operators)
4. ui/__init__.py - exports OPERATOR_CLASSES, PANEL_CLASSES, preferences
5. ui/preferences.py - SearchPathItem, DynamicLinkManagerPreferences
6. ui/panels.py - PropertyGroups (LinkedDatablockItem, LinkedLibraryItem, DynamicLinkManagerProperties), DLM_UL_library_list, DLM_PT_main_panel. Note: the panel currently draws both CharMig (to be added) and Linked Libraries - for now I'll put the same content and add CharMig in step 5.
7. ui/operators.py - all operator classes; scan and find_libraries will call ops.library
8. Root __init__.py - import from .ui, register CLASSES, ensure_default_search_path, register scene props
I need to fix the package references: operators use __package__ which in root is the addon name. When we move to ui/operators.py, __package__ will be addon.ui. So we need the preferences to be looked up with the root package. In Blender addons, the root __package__ is e.g. "dynamic_link_manager" (from manifest id or folder name). When we have from . import ui and ui has operators, the operators are still registered under the addon - and context.preferences.addons.get(__package__) in the root __init__ gets the addon. If operators are in ui.operators, when they do context.preferences.addons.get(__package__), __package__ will be "dynamic_link_manager.ui" or similar. So we need to use the root package for preferences. The root __init__.py has __name__ which could be "dynamic_link_manager" or "__main__". So in ui/operators.py we should use the parent package for addon prefs. We can do context.preferences.addons.get(__package__.split('.')[0]) or store the root package in a constant. Let me check the manifest - the id is "dynamiclinkmanager". So the folder is likely Dynamic_Link_Manager and the module name might be dynamic_link_manager. So __package__ in ui/operators will be "dynamic_link_manager.ui". So we need get(__package__.rsplit('.', 1)[0]) to get "dynamic_link_manager". I'll add that.
Creating the files. First the directory structure and utils, ops (empty), then ui files.
Tool use: **edit_file_v2** • Edit file: T:\Dynamic-Link-Manager\utils\__init__.py
Tool use: **edit_file_v2** • Edit file: T:\Dynamic-Link-Manager\ops\__init__.py
Thought Process
Now I need to create ui/preferences.py with the preferences and SearchPathItem. Then ui/panels.py with the property groups, UIList, and panel. Then ui/operators.py with all operators. The operators reference context.scene.dynamic_link_manager and context.preferences.addons.get(__package__). When operators live in ui.operators, __package__ is "dynamic_link_manager.ui" (assuming the root package is dynamic_link_manager). So I need to get the root package. In Blender, the addon is typically loaded with a name - let me check the manifest: id = "dynamiclinkmanager". So the module name might be different. I'll use a helper: get the addon module from the operator's module's parent. So in ui/operators we can do:
import sys
_root = sys.modules.get(__name__.rsplit('.', 1)[0])
addon_name = _root.__name__ if _root else __package__.rsplit('.', 1)[0]
Then context.preferences.addons.get(addon_name). Actually in Blender, the addon's register() is called with __name__ being the root module. So when we're in dynamic_link_manager.ui.operators, we want to get "dynamic_link_manager" for the addon lookup. So addon_name = __package__.rsplit('.', 1)[0]. That should work.
Tool use: **edit_file_v2** • Edit file: T:\Dynamic-Link-Manager\ui\preferences.py
Thought Process
I need a properties module for SearchPathItem so preferences can import it. Let me put SearchPathItem and the other property groups in ui/properties.py, then preferences and panels can import from it.
Tool use: **read_file_v2** • Read file: T:\Dynamic-Link-Manager\ui.py
Thought Process
I'll create ui/properties.py with SearchPathItem, LinkedDatablockItem, LinkedLibraryItem, DynamicLinkManagerProperties. Then I need to add migrator props (original_character, replacement_character) to DynamicLinkManagerProperties - the plan says scene or wm props. I'll add them in step 4. For now just the existing props.
Tool use: **edit_file_v2** • Edit file: T:\Dynamic-Link-Manager\ui\properties.py
Thought Process
I used PointerProperty for original_character and replacement_character so the picker can set the active object. Now fix preferences to use the correct import - I had from . import properties, and SearchPathItem is in properties. Good. Now create panels.py with the UIList and the main panel. The panel will draw CharMig section first (mode, two fields + pickers, Run migration) and then Linked Libraries in a dropdown. I'll add the CharMig UI in step 5; for the restructure I'll just have the Linked Libraries content in a dropdown (same as now but inside a collapsible). Let me create panels.py with the current content reorganized: main panel with Linked Libraries in its own dropdown. CharMig will be added in todo 5.
Tool use: **edit_file_v2** • Edit file: T:\Dynamic-Link-Manager\ui\panels.py
Thought Process
I already added the CharMig UI and migrator props in properties. Now I need to create ui/operators.py with all the library operators plus the three migrator operators (run_character_migration, picker_original_character, picker_replacement_character). The library operators use context.scene.dynamic_link_manager and context.preferences.addons.get(__package__). When in ui.operators, __package__ is "dynamic_link_manager.ui" so we need .rsplit(".", 1)[0] for the addon name. Let me use a variable at top of operators: ADDON_NAME = __package__.rsplit(".", 1)[0] if "." in __package__ else __package__.
Tool use: **read_file_v2** • Read file: T:\Dynamic-Link-Manager\operators.py
Thought Process
I'll write the full ui/operators.py by copying the operators from the current operators.py and fixing the addon lookup to use the root package. I also need to add the three migrator operators. Let me write the file in chunks - first the imports and addon name, then all operator classes, then register/unregister. The register in the current file has duplicate register() - the first one only registers 2 classes. So the full list is: DLM_OT_replace_linked_asset, DLM_OT_scan_linked_assets, DLM_OT_find_libraries_in_folders, DLM_OT_open_linked_file, DLM_OT_add_search_path, DLM_OT_remove_search_path, DLM_OT_browse_search_path, DLM_OT_attempt_relink, DLM_OT_reload_libraries, DLM_OT_make_paths_relative, DLM_OT_make_paths_absolute, DLM_OT_relocate_single_library. Plus DLM_OT_run_character_migration, DLM_OT_picker_original_character, DLM_OT_picker_replacement_character. The migrator operators will call into ops.migrator when we implement it; for now I can add stubs that report "Not implemented" or I can implement the migrator in ops/migrator.py first. According to the implementation order I should do restructure first (so operators can be stubs), then utils, then ops/migrator, then wire up the operators. So for the restructure I'll add the three migrator operators as stubs that report "Run migration after migrator is implemented" or we could already have them call ops.migrator.run_full_migration once we create that module. Let me create ops/migrator.py in step 3 with the full logic, and in step 4 we "add migrator props and operators". So for step 1 (restructure) I'll add the picker and run operators as stubs that just report a message, and in step 3/4 we'll implement them. Actually re-reading the todo: step 4 is "Migrator props and operators" - so the operators are added in step 4. So for the restructure (step 1) I need the panel to not reference dlm.picker_original_character etc. until we have those operators. So I'll register stub operators in step 1 that do nothing or report INFO, and in step 4 we replace them with the real implementation. Or I can add the operator classes now and have them call ops.migrator.run_full_migration(context) which we'll implement in step 3 - so the operators exist but run_full_migration will be implemented in step 3. So in step 1 I add the three operator classes: run_character_migration calls ops.migrator.run_full_migration(context), picker_original sets context.scene.dynamic_link_manager.original_character = context.active_object, picker_replacement sets .replacement_character. So I need ops.migrator to exist and define run_full_migration. So the order is: 1) restructure with stub run_full_migration in ops/migrator (raises NotImplementedError or reports error), 2) utils, 3) ops/migrator full impl, 4) operators already have the three - just need to make sure they're registered. So for step 1 I'll create ops/migrator.py with a stub run_full_migration that returns an error message, and get_pair_manual/automatic that return (None, None). Then ui/operators has the three operators. Let me do that.
Tool use: **edit_file_v2** • Edit file: T:\Dynamic-Link-Manager\ops\migrator.py
Thought Process
get_pair_automatic has a bug: we're building seen_bases from two different patterns and might get inconsistent pairs. The spec says scan for *_Rigify and *_Rigify.001 with same base. So we should collect all armatures that match *_Rigify (no .001) as originals and *_Rigify.001 as replacements, then pair by base name. Let me fix that in step 3 when we implement fully. For now the stub is fine.
Tool use: **read_file_v2** • Read file: T:\Dynamic-Link-Manager\operators.py
Thought Process
I need to fix the attempt_relink operator - it references lib_item.has_indirect_missing and lib_item.indirect_missing_count which don't exist on LinkedLibraryItem. I'll remove those lines when writing ui/operators. Now write the full ui/operators.py. I'll use ADDON_NAME = __package__.rsplit(".", 1)[0] for the addon lookup.
Tool use: **edit_file_v2** • Edit file: T:\Dynamic-Link-Manager\ui\operators.py
Thought Process
I referenced ..ops.library (scan_linked_assets, find_libraries_in_folders, attempt_relink). I need to create ops/library.py with those functions that take (context, report) and return {'FINISHED'} or {'CANCELLED'}. Let me extract the logic from the current operators.py into ops/library.py.
Tool use: **read_file_v2** • Read file: T:\Dynamic-Link-Manager\operators.py
Thought Process
I need to create ops/library.py with:
1. scan_linked_assets(context, report) - the full scan logic, report is a method that takes (type, msg) e.g. self.report
2. find_libraries_in_folders(context, report)
3. attempt_relink(context, report)
The report in Blender is typically self.report({'INFO'}, "msg"). So the library functions will receive a callable that we can do report({'INFO'}, "msg"). So signature: def scan_linked_assets(context, report): ... report({'INFO'}, "Found ..."); return {'FINISHED'}.
Tool use: **edit_file_v2** • Edit file: T:\Dynamic-Link-Manager\ops\library.py
Thought Process
In ops/library.py I used __package__ which will be "ops" or "dynamic_link_manager.ops" when imported from the addon. So __package__.rsplit(".", 1)[0] would give "dynamic_link_manager" when the addon is loaded as dynamic_link_manager. But when we're in ops/library.py, __package__ is the package of that module - so it's the parent of "library", which is "ops". So we don't have the addon name in ops. We need to pass the addon name or get it differently. The ui/operators.py calls library.scan_linked_assets(context, self.report) - so the addon name isn't needed for scan. For find_libraries_in_folders and attempt_relink we need prefs. We get prefs via context.preferences.addons.get(ADDON_NAME). So we need the addon name in ops/library. The addon name could be passed as an argument, or we could get it from context - but context doesn't have the addon name. The standard way is to use a module that knows its root: e.g. in ui/operators we have ADDON_NAME. So the library functions could accept an optional addon_name parameter, or we could try common names. Actually the simplest is: in find_libraries_in_folders and attempt_relink, iterate context.preferences.addons and find the one that has .preferences.search_paths (our addon). Or we can pass addon_name from the operator. Let me pass addon_name from the operator to the library functions that need it. So find_libraries_in_folders(context, report, addon_name) and attempt_relink(context, report, addon_name). And in ui/operators we'll pass ADDON_NAME. Let me update ops/library.py to accept addon_name for find and attempt_relink. Actually a simpler approach: get the addon that has the search_paths. We can do: for name, addon in context.preferences.addons.items(): if getattr(getattr(addon, 'preferences', None), 'search_paths', None) is not None: prefs = addon.preferences; break. That's fragile. Cleaner: pass addon_name from the operator. So I'll add an optional addon_name to find_libraries_in_folders and attempt_relink. When called from the operator we pass ADDON_NAME. But the operator is in ui.operators and it imports ..ops.library - so from ui/operators.py the addon name is ADDON_NAME. So in the operator execute we call library.find_libraries_in_folders(context, self.report, ADDON_NAME). Same for attempt_relink. Let me update library.py to take addon_name as the third parameter and update the operators to pass it.
Tool use: **edit_file_v2** • Edit file: T:\Dynamic-Link-Manager\ops\library.py
Tool use: **edit_file_v2** • Edit file: T:\Dynamic-Link-Manager\ops\library.py
Tool use: **edit_file_v2** • Edit file: T:\Dynamic-Link-Manager\ui\operators.py
Tool use: **edit_file_v2** • Edit file: T:\Dynamic-Link-Manager\ui\operators.py
Thought Process
The addon's root package name: the folder is Dynamic-Link-Manager. In Blender, addons are typically loaded by folder name; the manifest has id = "dynamiclinkmanager". So the Python package could be "dynamic_link_manager" (with underscores) if the folder is renamed, or it might be "Dynamic_Link_Manager" or similar. Let me check - when you have a folder "Dynamic-Link-Manager", Blender might import it as a module - Python doesn't allow hyphens in module names, so the folder might be "dynamic_link_manager" or the addon might be loaded differently. I'll leave ADDON_NAME as __package__.rsplit(".", 1)[0] which from ui.operators gives the parent of "ui", i.e. the root package. So when the addon is loaded as "dynamic_link_manager", ui.__package__ is "dynamic_link_manager.ui", and ADDON_NAME is "dynamic_link_manager". Good. Now create ui/__init__.py and update root __init__.py.
Tool use: **edit_file_v2** • Edit file: T:\Dynamic-Link-Manager\ui\__init__.py
Thought Process
We need to register all property groups and the scene property. So the classes to register are: SearchPathItem, LinkedDatablockItem, LinkedLibraryItem, DynamicLinkManagerProperties, DynamicLinkManagerPreferences, DLM_UL_library_list, DLM_PT_main_panel, and all OPERATOR_CLASSES. And bpy.types.Scene.dynamic_link_manager = PointerProperty(type=DynamicLinkManagerProperties). Let me list all classes that need registration from ui: properties: SearchPathItem, LinkedDatablockItem, LinkedLibraryItem, DynamicLinkManagerProperties. preferences: DynamicLinkManagerPreferences. panels: DLM_UL_library_list, DLM_PT_main_panel. operators: OPERATOR_CLASSES. So we need to export from ui/__init__.py a flat list of all classes for the root register. Let me build CLASSES in ui/__init__.py that includes everything in the right order (unregister reverse).
Tool use: **edit_file_v2** • Edit file: T:\Dynamic-Link-Manager\ui\__init__.py
Thought Process
Now update the root __init__.py to import from .ui and register CLASSES, and register the scene property. Also ensure_default_search_path should use the addon name - when we're in the root __init__, __name__ is the addon module name.
Tool use: **edit_file_v2** • Edit file: T:\Dynamic-Link-Manager\__init__.py
Thought Process
Now I need to remove or keep the old ui.py and operators.py at the root. The plan says to move existing code into ui/ and ops/, so the old files should be removed so the addon doesn't try to load them. If we keep them, the root __init__ would still import from .ui (the package), so the old ui.py and operators.py at root would be orphaned (root __init__ no longer imports from .operators or .ui as modules - it imports from .ui the package). So we should delete the old ui.py and operators.py at the root to avoid confusion. Let me delete them.
Tool use: **read_file_v2** • Read file: T:\AmazonCharacterTools\__init__.py
Tool use: **read_file_v2** • Read file: T:\Dynamic-Link-Manager\ui\preferences.py
Thought Process
When the addon is loaded, the root package could be "dynamic_link_manager" (if the folder is named that) or something else. The manifest says id = "dynamiclinkmanager". So the folder might be "dynamic_link_manager" to be a valid Python module. The preferences bl_idname should match the addon's module name so that Blender finds the preferences. So when the addon is loaded as __name__ = "dynamic_link_manager", the preferences need bl_idname = "dynamic_link_manager". In ui/preferences.py, __package__ is "dynamic_link_manager.ui", so rsplit(".", 1)[0] = "dynamic_link_manager". That's correct. Set bl_idname at register time in root __init__ to __name__ to be safe (like AmazonCharacterTools does with __package__). Let me set it in register(): DynamicLinkManagerPreferences.bl_idname = __name__
Tool use: **edit_file_v2** • Edit file: T:\Dynamic-Link-Manager\__init__.py
Tool use: **edit_file_v2** • Edit file: T:\Dynamic-Link-Manager\__init__.py
Tool use: **delete_file**
Explanation: undefined
Tool use: **delete_file**
Explanation: undefined
Thought Process
Blender addon folder name: often it's the folder name with hyphens replaced by underscores. So "Dynamic-Link-Manager" might be loaded as "Dynamic_Link_Manager" or "dynamic_link_manager" depending on the manifest. The manifest has id = "dynamiclinkmanager" - that's the addon id for the UI, not the Python module name. The Python module name is the folder name. So if the folder is "Dynamic-Link-Manager", Python might not load it as a module because of the hyphen. So the folder is likely "dynamic_link_manager" or similar. I'll leave as is. Let me run a quick test - we can't run Blender from here easily, but we can check for syntax/import errors. Let me also fix the panels to use the scene prop for migrator_mode - I used BoolProperty for "Automatic" - the plan says "Manual vs Automatic" so False = Manual, True = Automatic. And the panel draws "Automatic pair discovery" for the bool - so when True we use automatic. Good. Now mark todo 1 complete and move to todo 2 (utils).
Tool use: **todo_write** • Todo List
- [x] Restructure: create ui/, ops/, utils/; move existing code
- [-] utils: descendants() and collection-containing-armature helper
- [ ] ops/migrator.py: steps 1-6, get_pair_manual/automatic, run_full_migration
- [ ] Migrator props and operators (run migration, pickers)
- [ ] UI: CharMig section + Linked Libraries dropdown
- [ ] Update blender_manifest.toml and __init__ registration
Tool use: **read_file_v2** • Read file: T:\Dynamic-Link-Manager\utils\__init__.py
Thought Process
Add to utils: 1) descendants(armature) - set of objects whose parent chain leads to that armature. 2) collection_containing_armature(armature) - the collection that contains the armature (e.g. root character collection). We can use armature.users_collection - often the character is in one collection. Return the first collection that contains the armature, or the one that matches the character "base" name. The plan says "e.g. by considering the armature's users_collection or a collection whose name matches the character base".
Tool use: **edit_file_v2** • Edit file: T:\Dynamic-Link-Manager\utils\__init__.py
Thought Process
Todo 2 done. Todo 4 (migrator props and operators) is already done - we have the props in properties.py and the three operators. Todo 5 (UI) is already done - we have CharMig section and Linked Libraries dropdown in panels.py. So I'll mark 2 complete and move to 3 (ops/migrator full implementation).
Tool use: **todo_write** • Todo List
- [x] Restructure: create ui/, ops/, utils/; move existing code
- [x] utils: descendants() and collection-containing-armature helper
- [-] ops/migrator.py: steps 1-6, get_pair_manual/automatic, run_full_migration
- [ ] Migrator props and operators (run migration, pickers)
- [ ] UI: CharMig section + Linked Libraries dropdown
- [ ] Update blender_manifest.toml and __init__ registration
Thought Process
Implement the full migrator: steps 1-6 (step 7 inside step 4). I'll need to read the spec again for the exact logic. From the plan:
Step 1: Copy armature object attributes (location, rotation quaternion/euler, scale) from original to replacement.
Step 2: Migrate NLA - copy tracks and strips, blend_type, extrapolation, frame_end, blend_in/out, repeat. Create animation_data on rep if missing.
Step 3: Custom properties - copy pose-bone custom props, exclude _RNA_UI, rigify_type, rigify_parameters.
Step 4: (a) On replacement, remove constraints that target another character's original. (b) Copy constraints from orig to rep: skip if target==orig; if target is other orig then set nc.target = other's rep; else keep. Copy name, mute, influence, subtarget, etc. (c) Trim rep constraints so count matches orig (remove from end).
Step 5: Retarget relations - parents, constraint targets, Armature modifiers pointing at orig → rep; any object in file whose parent is orig → rep, etc.
Step 6: Replacement base body - for each rep base body mesh (body+base in name, skinned to rep): if linked/override do override_create() only. Assign shape-key action.
orig_to_rep for a single pair is {orig: rep}. So when we have one pair, other_originals = [] for step 4 (no other character). So we only need to skip constraints that target orig (same character). Cross-character: if we had multiple pairs we'd have orig_to_rep mapping. For one pair, orig_to_rep = {orig: rep}. So "other character's original" = any key in orig_to_rep that is not orig = empty. So step 4 (a) remove from rep constraints where target in other_originals = no-op for single pair. (b) copy constraints, skip target==orig, if target in orig_to_rep set nc.target = orig_to_rep[target] (so we'd set rep when target is orig? No - we skip when target==orig. So when target is another character's orig we retarget. For single pair there is no "other" orig. So the logic is fine.)
Let me implement run_step_1 through run_step_6 and run_full_migration in ops/migrator.py. I'll use the utils.descendants and utils.collection_containing_armature.
Tool use: **read_file_v2** • Read file: a:\1 Amazon_Active_Projects\260206_PAE_2026\.specstory\history\2026-02-17_17-20Z-linked-library-override-resync-issue.md
Thought Process
I have the logic. For step 6 the spec says: if ob.data has library or override_library, call ob.data.override_create(). Then assign shape-key action - and we need to ensure shape_keys have animation_data (create if needed). Let me also note: step 6 says "if ob.data.shape_keys and ob.data.shape_keys.animation_data" - so we only assign action when animation_data exists. We might need to create animation_data on shape_keys if we want to assign an action. Let me check - we assign ob.data.shape_keys.animation_data.action = action. So if shape_keys exist but animation_data doesn't, we'd need shape_keys.animation_data_create() first. I'll add that.
Now write the full migrator. I need to handle the case where we have one pair - orig_to_rep = {orig: rep}. So "other" originals = empty. The cross-character retargeting only matters when there are multiple pairs; for one pair we still implement the logic (remove stale constraints targeting "other" orig - none; copy constraints with retarget if target in orig_to_rep - when target is orig we skip, so we never set nc.target = rep from that; when target is "other" orig we'd set to other rep - no other). So the code is the same.
Let me also fix get_pair_automatic - the current stub has a bug. We want to find all base names that have both Name_Rigify and Name_Rigify.001, then return the first pair. So:
for obj in bpy.data.objects:
if type != ARMATURE: continue
if name ends with "_Rigify.001": base = name[:-len("_Rigify.001")], if base_Rigify exists, pair = (base_Rigify, obj)
or: collect all origs (name has _Rigify and not .001), collect all reps (_Rigify.001). Match by base.
bases = set()
for o in armatures:
if "_Rigify.001" in o.name: base = o.name.replace("_Rigify.001",""); orig = bpy.data.objects.get(base+"_Rigify"); if orig: yield (orig, o) or add to list
Actually we need to return one pair. So build list of (orig, rep) for all bases that have both, then return the first.
Tool use: **edit_file_v2** • Edit file: T:\Dynamic-Link-Manager\ops\migrator.py
Thought Process
Step 6 base body: the spec says "mesh with 'body' and 'base' in name, skinned to rep". So we need to check that the mesh has an Armature modifier pointing at rep. I did that with the "for m in ob.modifiers: if m.type == ARMATURE and m.object == rep: break; else: continue" - so we only process meshes that have an armature modifier targeting rep. Good. But I used "name_lower" from ob.name and ob.data.name - the spec says "mesh with 'body' and 'base' in name". So the object name or the mesh data name should contain both. Good.
Fix the step 6 logic: we should only consider meshes that are skinned to rep (armature modifier with rep). So the loop should be: for ob in rep_descendants, if not MESH continue, check 'body' and 'base' in name (ob.name or ob.data.name), check that it has armature modifier with rep. Then override_create and action. I had the modifier check as "if we have modifiers and one is armature pointing to rep then we're good, else continue". So we skip if no armature modifier to rep. Good.
Let me double-check the run_step_4 retarget: when we copy a constraint and the target is in orig_to_rep, we set nc.target = orig_to_rep[t]. So when t is the other character's orig, we set to that character's rep. When we have only one pair, orig_to_rep = {orig: rep}, so "other" is empty, and we only skip when t == orig. So we never set nc.target = orig_to_rep[orig] because we skip when target == orig. Good.
Read lints and fix any issues. Also fix the migrator_mode in the panel - the plan says "Manual" vs "Automatic". So when migrator_mode is True we use automatic. The prop is "Automatic pair discovery" in the panel. Good.
Tool use: **read_lints**
Parameters:
```json
{
"paths": [
"T:\\Dynamic-Link-Manager\\ops\\migrator.py",
"T:\\Dynamic-Link-Manager\\ui\\operators.py",
"T:\\Dynamic-Link-Manager\\ui\\panels.py",
"T:\\Dynamic-Link-Manager\\__init__.py"
]
}
```
Result:
```json
{
"linterErrorsByFile": [
{
"relativeWorkspacePath": "T:\\Dynamic-Link-Manager\\ops\\migrator.py"
},
{
"relativeWorkspacePath": "T:\\Dynamic-Link-Manager\\ui\\operators.py"
},
{
"relativeWorkspacePath": "T:\\Dynamic-Link-Manager\\ui\\panels.py"
},
{
"relativeWorkspacePath": "T:\\Dynamic-Link-Manager\\__init__.py"
}
]
}
```
Status: **completed**
---
Thought Process
ops/migrator uses "from ..utils" - when the addon is loaded, the root might be "dynamic_link_manager", so ..utils from ops is dynamic_link_manager.utils. Good. Let me verify the addon can be loaded - the folder name might be "Dynamic-Link-Manager" with a hyphen which isn't a valid Python module. Let me check the workspace path: T:\Dynamic-Link-Manager. So the folder is Dynamic-Link-Manager. In that case Python might not load it as a package because of the hyphen. Blender often uses the folder name; I've seen addons with hyphens in the folder - Blender might normalize it. I'll leave as is. If there are import errors the user would see them when enabling the addon.
Mark todo 3 complete. Todo 4 and 5 are already done (we have migrator props, operators, and UI). Todo 6: update blender_manifest.toml and ensure __init__ registers migrator props - we already register the scene property and the props are on DynamicLinkManagerProperties. So we just need to update the manifest.
Tool use: **todo_write** • Todo List
- [x] Restructure: create ui/, ops/, utils/; move existing code
- [x] utils: descendants() and collection-containing-armature helper
- [x] ops/migrator.py: steps 1-6, get_pair_manual/automatic, run_full_migration
- [x] Migrator props and operators (run migration, pickers)
- [x] UI: CharMig section + Linked Libraries dropdown
- [-] Update blender_manifest.toml and __init__ registration
Tool use: **read_file_v2** • Read file: T:\Dynamic-Link-Manager\blender_manifest.toml
Thought Process
Update the tagline to include character migrator. The plan says "Update description/tagline to include character migrator as main feature."
Tool use: **edit_file_v2** • Edit file: T:\Dynamic-Link-Manager\blender_manifest.toml
Tool use: **todo_write** • Todo List
- [x] Restructure: create ui/, ops/, utils/; move existing code
- [x] utils: descendants() and collection-containing-armature helper
- [x] ops/migrator.py: steps 1-6, get_pair_manual/automatic, run_full_migration
- [x] Migrator props and operators (run migration, pickers)
- [x] UI: CharMig section + Linked Libraries dropdown
- [x] Update blender_manifest.toml and __init__ registration
Thought Process
All todos are complete. Let me verify the panel uses migrator_mode correctly for automatic vs manual. In run_full_migration we do: use_auto = props and getattr(props, "migrator_mode", False). So when migrator_mode is True we use get_pair_automatic. When False we use get_pair_manual. The UI has "Automatic pair discovery" for the bool - so when checked we use automatic. Good.
One more thing: the panel draws the migrator section with two PointerProperty fields (original_character, replacement_character). In Blender, PointerProperty to Object with poll=lambda self, obj: obj.type == "ARMATURE" should show an object selector. The picker buttons set the active object to that prop. Good.
Let me also ensure that when we're in automatic mode we don't require the two fields to be set - we discover the pair. So run_full_migration is correct.
I'll double-check the ops/migrator import: from ..utils import descendants. The package structure is: dynamic_link_manager (or Dynamic_Link_Manager?), ui, ops, utils. So from ops.migrator, .. is the root, ..utils is the utils package. So we need the root package name to be something that has utils. When the addon is loaded, the root could be "dynamic_link_manager" if the folder is named that. If the folder is "Dynamic-Link-Manager", Blender might still load it - I'm not sure how Blender resolves that. Let me leave the import as is. If the addon folder is "dynamic_link_manager", then ops is dynamic_link_manager.ops and ..utils is dynamic_link_manager.utils. Good.
Let me run a quick test to see if there are any import errors when loading the addon. We can run Python and try to import the package. But the package name depends on the folder name. Let me check - in the workspace the path is T:\Dynamic-Link-Manager. So the folder name has a hyphen. When you install an addon in Blender, you typically zip the folder or point to the folder. The module name would be the folder name with hyphens - and Python doesn't allow hyphens in module names. So the addon might be installed as part of a path that gets added to sys.path and the module might be imported differently. I'll leave the code as is.
Summary for the user.
Thought Process
The user wants the Linked Libraries Analysis section to be collapsible and collapsed by default. I need to:
1. Add a property to control whether the Linked Libraries section is expanded or collapsed (separate from the existing linked_libraries_expanded which is for the library list inside)
2. Make the Linked Libraries Analysis box use a collapsible header so it can be collapsed/expanded
3. Set the default to collapsed
Let me check the current UI structure in panels.py.
Tool use: **read_file_v2** • Read file: T:\Dynamic-Link-Manager\ui\panels.py
Tool use: **read_file_v2** • Read file: T:\Dynamic-Link-Manager\ui\properties.py
Thought Process
I need to:
1. Add a new BoolProperty to DynamicLinkManagerProperties for the Linked Libraries Analysis box: e.g. `linked_libraries_section_expanded` with default=False (collapsed by default).
2. In panels.py, wrap the entire Linked Libraries Analysis box content in a collapsible. In Blender UI we use layout.prop(..., "property", text="", icon=icon, icon_only=True) to get a clickable disclosure triangle, then only draw the content when expanded. So the structure should be:
- A row with the disclosure triangle + "Linked Libraries Analysis" label
- When expanded, draw the rest (scan button, then the inner expanded list etc.)
I'll add `linked_libraries_section_expanded` with default=False.
Tool use: **edit_file_v2** • Edit file: T:\Dynamic-Link-Manager\ui\properties.py
Tool use: **edit_file_v2** • Edit file: T:\Dynamic-Link-Manager\ui\panels.py
Thought Process
Done. The Linked Libraries Analysis box is now:
1. Collapsible via a disclosure triangle that toggles `linked_libraries_section_expanded`
2. Collapsed by default (`default=False`)
3. When collapsed, only the header row is shown (triangle + "Linked Libraries Analysis" + library count)
4. When expanded, the full content (scan button, inner list, search paths, etc.) is shown
Thought Process
The user wants the Linked Libraries Analysis to collapse at the "main box" level - meaning the entire box (the outer container) should be what collapses, not have the header inside the box with content below. So the collapse control should be on the box itself, and when collapsed we only show the box header (the row with the triangle and "Linked Libraries Analysis"), and the box shouldn't show any content inside when collapsed.
In Blender UI, a common pattern is to have a box, and the first row of the box is the header with the disclosure triangle. When collapsed, we don't draw the rest. So the "box" is still there but only the header row is visible. That's what I did - the box contains the header row and when expanded, the content. So the collapse IS at the box level - the whole box content (except the header row) is hidden when collapsed.
Maybe the user means the opposite: they want the Linked Libraries section to be higher up? "Too low down" might mean the collapse control is too far down the panel, or the visual hierarchy is wrong.
Re-reading: "it should collapse at the main box" - perhaps they mean the entire "Linked Libraries Analysis" should be one box that collapses as a unit, and the collapse toggle should be the main/only control for that box. Currently I have:
- Box
- Row: [triangle] Linked Libraries Analysis (count)
- When expanded: scan button, then inner expanded list, etc.
So the box already collapses - when you click the triangle, the whole content inside the box (except the header row) collapses. Maybe the issue is that the header row is INSIDE the box, so visually the "box" still has a border around the header. Perhaps they want the box to literally not be drawn when collapsed - i.e. just a row with the triangle and label, and when expanded THEN we draw the box around the content? So when collapsed it would be:
Row: [triangle] Linked Libraries Analysis (count)
(no box)
When expanded:
Row: [triangle] Linked Libraries Analysis (count)
Box:
... content ...
That way when collapsed there's no box at all - just the header row. So the "main box" only appears when expanded. Let me try that - when collapsed, draw only a row (no box). When expanded, draw the row then a box with all the content.
Tool use: **read_file_v2** • Read file: T:\Dynamic-Link-Manager\ui\panels.py
Thought Process
I'll change it so:
- When collapsed: only a row with the disclosure triangle + "Linked Libraries Analysis" + count (no box around it).
- When expanded: the same header row, then layout.box() and put all the content inside that box.
So the "main box" only appears when the section is expanded.
Tool use: **edit_file_v2** • Edit file: T:\Dynamic-Link-Manager\ui\panels.py
Thought Process
Done. Now when collapsed: only the header row is shown (triangle + "Linked Libraries Analysis" + count) at the same level as the CharMig box - no box around it. When expanded: that same row, then a single main box that contains all the scan/list/search paths/selected library content. So the collapse is at the "main box" level - the box only appears when you expand.
Thought Process
The user wants to:
1. Keep `linked_libraries_section_expanded` (the main section collapse)
2. Remove `linked_libraries_expanded` (the inner "Linked Libraries" list expand/collapse)
So I need to remove the property and change the UI so that when the section is expanded, the library list and everything inside is always shown (no inner collapse). I'll remove the `linked_libraries_expanded` property and flatten the UI so the list is always visible when the section is expanded.
Tool use: **edit_file_v2** • Edit file: T:\Dynamic-Link-Manager\ui\properties.py
Tool use: **edit_file_v2** • Edit file: T:\Dynamic-Link-Manager\ui\panels.py
Thought Process
I need to fix the properties file - I may have broken the BoolProperty by merging. Let me check what the property block looks like now.
Tool use: **read_file_v2** • Read file: T:\Dynamic-Link-Manager\ui\properties.py
Thought Process
Good - the properties file is correct. linked_libraries_expanded was removed and linked_libraries_section_expanded is intact. Done.
Thought Process
The user wants to split the character migration into individual step operators, each with its own button. Then `run_character_migration` should simply invoke all of those operators in sequence (so it can be run as one action, but each step is also available individually).
Let me check the current migrator steps and how run_full_migration works, so I can plan the operators and UI.
Tool use: **read_file_v2** • Read file: T:\Dynamic-Link-Manager\ops\migrator.py
Tool use: **read_file_v2** • Read file: T:\Dynamic-Link-Manager\ui\operators.py
Tool use: **read_file_v2** • Read file: T:\Dynamic-Link-Manager\ui\panels.py
Thought Process
There are 6 steps in the migrator (step 7 is inside step 4). So I need:
1. DLM_OT_migrator_step_1 - Copy attributes (location, rotation, scale)
2. DLM_OT_migrator_step_2 - Migrate NLA
3. DLM_OT_migrator_step_3 - Custom properties
4. DLM_OT_migrator_step_4 - Bone constraints (includes step 7 trim)
5. DLM_OT_migrator_step_5 - Retarget relations
6. DLM_OT_migrator_step_6 - Replacement base body
Each operator will:
- Resolve the pair (manual or automatic from props)
- Call the corresponding run_step_N from ops.migrator
- Report success/failure
For steps 4 and 5 they need orig_to_rep (dict) and rep_descendants. So each step operator needs to get (orig, rep) then build orig_to_rep = {orig: rep} and rep_descendants = descendants(rep) when needed.
run_character_migration will then just execute the 6 operators in order via bpy.ops.dlm.migrator_step_1(), ... step_6(). We need to be careful: calling bpy.ops from Python passes context; the operators need to get the pair from context.scene.dynamic_link_manager each time. So run_character_migration can do:
bpy.ops.dlm.migrator_step_1()
bpy.ops.dlm.migrator_step_2()
...
(or we could keep calling the run_step_N functions directly from run_character_migration to avoid 6 operator invocations - but the user said "invoke every single operator". So they want run_character_migration to literally call the operators. So each operator is a wrapper that gets pair, calls run_step_N. And run_character_migration does for i in 1..6: bpy.ops.dlm.migrator_step_i(). We need to pass context - in Blender, when you call bpy.ops.x from another operator's execute(), you use context. So it would be context.ops.dlm.migrator_step_1() or we need to get the right context. Actually in Blender, from an operator's execute we do bpy.ops.dlm.migrator_step_1() - that uses the current context. So we're good.
Plan:
1. Add 6 new operators in ui/operators.py: DLM_OT_migrator_step_1 through DLM_OT_migrator_step_6. Each gets (orig, rep) from context (manual or automatic), then calls the corresponding run_step_N from ops.migrator. Steps 4 and 5 need orig_to_rep and rep_descendants - they get that from orig, rep (orig_to_rep = {orig: rep}, rep_descendants = descendants(rep)).
2. Change DLM_OT_run_character_migration execute() to call bpy.ops.dlm.migrator_step_1() through bpy.ops.dlm.migrator_step_6() in sequence. If any returns CANCELLED, report and return CANCELLED.
3. In ui/panels.py, add 6 buttons for the 6 steps (and keep "Run migration" which runs all).
Let me also check the migrator for run_step_5 and run_step_6 signatures.
Tool use: **read_file_v2** • Read file: T:\Dynamic-Link-Manager\ops\migrator.py
Thought Process
I have the full picture. Each step operator needs to resolve the pair once; steps 4, 5, 6 need orig_to_rep and/or rep_descendants. So either each operator resolves the pair (and steps 4/5/6 also compute orig_to_rep and rep_descendants), or we have a small helper that returns (orig, rep, orig_to_rep, rep_descendants) and each operator uses that. I'll have each operator get the pair via the same logic as run_full_migration (manual/auto from props), then steps 4 and 5 also compute orig_to_rep = {orig: rep} and rep_descendants = descendants(rep).
Plan:
1. **ui/operators.py**: Add 6 operators (DLM_OT_migrator_step_1 … DLM_OT_migrator_step_6). Each in execute(): resolve (orig, rep) using migrator.get_pair_manual/automatic and props.migrator_mode; if no pair, report and CANCELLED. Then call the corresponding run_step_N. Steps 4 and 5 need orig_to_rep = {orig: rep} and rep_descendants = descendants(rep) from utils. Add these to OPERATOR_CLASSES.
2. **DLM_OT_run_character_migration**: In execute(), call in order: bpy.ops.dlm.migrator_step_1(), migrator_step_2(), ... migrator_step_6(). Use context. If any returns {'CANCELLED'}, report and return CANCELLED; else report success and FINISHED.
3. **ui/panels.py**: In the CharMig box, add a row with 6 buttons (Step 1: Copy attributes, Step 2: NLA, etc.) and keep the "Run migration" button (or put it first). Layout could be: Run migration (full); then Step 1, Step 2, ... Step 6 as individual buttons.
Creating the plan.
Tool use: **create_plan**
Parameters:
```json
{
"plan": "# Per-step character migrator operators\n\n## Goal\n\n- **Six step operators:** Step 1 (copy attributes), Step 2 (NLA), Step 3 (custom props), Step 4 (bone constraints + trim), Step 5 (retarget relations), Step 6 (base body override + shape-key action). Each is invokable on its own via a button.\n- **Run migration:** `bpy.ops.dlm.run_character_migration()` should invoke these six operators in order (no direct call to `run_full_migration` logic); it remains the “run all” action.\n\n## 1. New operators in [ui/operators.py](T:\\Dynamic-Link-Manager\\ui\\operators.py)\n\nAdd six operators, e.g. `DLM_OT_migrator_step_1` … `DLM_OT_migrator_step_6`, with `bl_idname` like `dlm.migrator_step_1` … `dlm.migrator_step_6`.\n\n**Shared behavior in each:**\n\n- In `execute(self, context)`:\n - Get pair from scene: `props = context.scene.dynamic_link_manager`, `use_auto = props.migrator_mode`, then `orig, rep = get_pair_automatic(context) if use_auto else get_pair_manual(context)` (using existing `get_pair_manual` / `get_pair_automatic` from [ops/migrator.py](T:\\Dynamic-Link-Manager\\ops\\migrator.py)).\n - If `not orig or not rep` or `orig == rep`: `self.report({'ERROR'}, ...)`, `return {'CANCELLED'}`.\n - Call the corresponding `run_step_N(...)` from `ops.migrator` (and for steps 4 and 5, also compute `orig_to_rep = {orig: rep}` and `rep_descendants = descendants(rep)` using [utils](T:\\Dynamic-Link-Manager\\utils\\__init__.py)).\n- Use `bl_options = {'REGISTER', 'UNDO'}` where appropriate (all steps modify data).\n- Keep logic in [ops/migrator.py](T:\\Dynamic-Link-Manager\\ops\\migrator.py) as-is; operators only resolve the pair and call `run_step_1` … `run_step_6`.\n\n**Step-specific calls:**\n\n| Operator | Calls |\n|---------------------|--------|\n| migrator_step_1 | `run_step_1(orig, rep)` |\n| migrator_step_2 | `run_step_2(orig, rep)` |\n| migrator_step_3 | `run_step_3(orig, rep)` |\n| migrator_step_4 | `orig_to_rep = {orig: rep}`, `run_step_4(orig, rep, orig_to_rep)` |\n| migrator_step_5 | `rep_descendants = descendants(rep)`, `orig_to_rep = {orig: rep}`, `run_step_5(orig, rep, rep_descendants, orig_to_rep)` |\n| migrator_step_6 | `rep_descendants = descendants(rep)`, `run_step_6(orig, rep, rep_descendants)` |\n\nWrap each `run_step_N` call in try/except; on exception report and return `{'CANCELLED'}`. On success report a short message and return `{'FINISHED'}`.\n\nAppend the six classes to `OPERATOR_CLASSES`.\n\n## 2. Change run_character_migration in [ui/operators.py](T:\\Dynamic-Link-Manager\\ui\\operators.py)\n\nIn `DLM_OT_run_character_migration.execute(self, context)`:\n\n- Do **not** call `run_full_migration(context)`.\n- Call in order: \n `bpy.ops.dlm.migrator_step_1()`, `bpy.ops.dlm.migrator_step_2()`, … `bpy.ops.dlm.migrator_step_6()`.\n- Use the same `context` (e.g. pass it if the Blender API requires it; typically `bpy.ops.dlm.migrator_step_1()` uses the current context).\n- If any of these returns `{'CANCELLED'}`, report which step failed and return `{'CANCELLED'}`.\n- If all return `{'FINISHED'}`, report success (e.g. “Migration complete”) and return `{'FINISHED'}`.\n\nSo the full migration is exactly “invoke the six step operators in sequence.”\n\n## 3. UI in [ui/panels.py](T:\\Dynamic-Link-Manager\\ui\\panels.py)\n\nIn the Character Migrator box, after the pair fields and pickers:\n\n- Keep one **“Run migration”** button that calls `dlm.run_character_migration` (runs all steps).\n- Add **six buttons**, one per step, e.g.:\n - “Step 1: Copy attributes” → `dlm.migrator_step_1`\n - “Step 2: Migrate NLA” → `dlm.migrator_step_2`\n - “Step 3: Custom properties” → `dlm.migrator_step_3`\n - “Step 4: Bone constraints” → `dlm.migrator_step_4`\n - “Step 5: Retarget relations” → `dlm.migrator_step_5`\n - “Step 6: Base body override” → `dlm.migrator_step_6`\n\nLayout can be one row for “Run migration” and then a row or column of the six step buttons (or two rows of three), depending on space.\n\n## 4. No changes to [ops/migrator.py](T:\\Dynamic-Link-Manager\\ops\\migrator.py)\n\nKeep `get_pair_manual`, `get_pair_automatic`, `run_step_1` … `run_step_6`, and `run_full_migration`. The add-on will use the step functions from the new operators and will use “run all” by invoking the six operators; `run_full_migration` can remain for any future or script use but is not required for the UI.\n\n## Summary\n\n- **New:** 6 operators in `ui/operators.py`, each resolving the pair and calling one `run_step_N`.\n- **Changed:** `DLM_OT_run_character_migration` only invokes those 6 operators in order.\n- **New UI:** 6 step buttons in the CharMig panel plus the existing “Run migration” button.\n- **Unchanged:** `ops/migrator.py`, pair resolution and step logic.\n",
"name": "Per-step migrator operators",
"overview": "Add one Blender operator per migrator step (steps 1–6), each with its own button in the CharMig UI, and change run_character_migration to invoke these six operators in sequence so the full migration is reproducible and each step can be run individually."
}
```
Additional data:
```json
{
"reviewData": {
"status": "Requested",
"selectedOption": "none",
"isShowingInput": false
},
"planUri": "file:///c%3A/Users/Nathan/.cursor/plans/per-step_migrator_operators_4986daf6.plan.md",
"hasOpenedEditor": true
}
```
Result:
```json
{
"rejected": {}
}
```
Status: **completed**
---
_**User**_
each step should be named after the step from the original specstory.
---
_**Agent (model default, mode Agent)**_
Thought Process
The user wants the step operators (and presumably their UI labels) to be named after the steps from the original spec story. Let me check the plan and the spec story for the exact step names used there.
From the plan file I created and the earlier context, the spec story steps were:
1. Copy attributes (location, rotation, scale)
2. Migrate NLA
3. Custom properties
4. Bone constraints (with cross-character retarget, trim duplicates)
5. Retarget relations
6. Replacement base body (library override + shape-key action)
7. (inside 4) Remove duplicate constraints
The spec story transcript might use slightly different wording. Let me search for how the steps were referred to in the spec.
Tool use: **ripgrep_raw_search**
Parameters:
```json
{
"pattern": "Step [0-9]|step [0-9]",
"path": "a:\\1 Amazon_Active_Projects\\260206_PAE_2026\\.specstory\\history\\2026-02-17_17-20Z-linked-library-override-resync-issue.md",
"contextBefore": 0,
"contextAfter": 0,
"caseInsensitive": false
}
```
Additional data:
```json
{
"isPruned": true,
"pattern": "Step [0-9]|step [0-9]",
"path": "a:\\1 Amazon_Active_Projects\\260206_PAE_2026\\.specstory\\history\\2026-02-17_17-20Z-linked-library-override-resync-issue.md",
"outputMode": "content",
"totalFiles": 1,
"totalMatches": 102,
"topFiles": [
{
"uri": "a:\\1 Amazon_Active_Projects\\260206_PAE_2026\\.specstory\\history\\2026-02-17_17-20Z-linked-library-override-resync-issue.md",
"matchCount": 40
}
]
}
```
Status: **completed**
---
Thought Process
From the spec story the steps are referred to as:
- Step 1: Copy attributes
- Step 2: NLA (migrate NLA / mirror tracks)
- Step 3: Custom properties (pose-bone custom properties)
- Step 4: Bone constraints (copy and retarget)
- Step 5: Retarget relations (parent, constraint target, Armature modifier)
- Step 6: Replacement base body (override + shape-key action)
- Step 7: (inside 4) Remove duplicate constraints
The plan document (character_migrator_integration) had a table:
| **1** | Copy armature object attributes: location, rotation (quaternion/euler), scale from original to replacement. |
| **2** | Migrate NLA: copy tracks and strips... |
| **3** | Custom properties: copy pose-bone custom props... |
| **4** | Bone constraints: (a) On replacement, remove... (b) Copy constraints... (c) Trim... |
| **5** | Retarget relations: ... |
| **6** | Replacement base body: ... |
| **7** | Implemented inside step 4: remove duplicate constraints |
So the canonical names from the spec/plan are:
1. Copy attributes (or "Copy armature object attributes")
2. Migrate NLA
3. Custom properties
4. Bone constraints
5. Retarget relations
6. Replacement base body
For operator bl_idname we need valid identifiers (lowercase, underscores). So:
- dlm.migrator_copy_attributes
- dlm.migrator_migrate_nla
- dlm.migrator_custom_properties
- dlm.migrator_bone_constraints
- dlm.migrator_retarget_relations
- dlm.migrator_replacement_base_body
And bl_label can be the human-readable spec name:
- "Copy attributes"
- "Migrate NLA"
- "Custom properties"
- "Bone constraints"
- "Retarget relations"
- "Replacement base body"
I'll update the plan file to use these names.
Tool use: **read_file_v2** • Read file: c:\Users\Nathan\.cursor\plans\per-step_migrator_operators_4986daf6.plan.md
Thought Process
I need to update the plan so that each step is named after the spec story. From the spec story the steps are:
1. Copy attributes
2. Migrate NLA (or "NLA")
3. Custom properties
4. Bone constraints
5. Retarget relations
6. Replacement base body
So the operator bl_idnames should be based on these names (snake_case for id):
- dlm.migrator_copy_attributes
- dlm.migrator_migrate_nla
- dlm.migrator_custom_properties
- dlm.migrator_bone_constraints
- dlm.migrator_retarget_relations
- dlm.migrator_replacement_base_body
And bl_label / button text:
- Copy attributes
- Migrate NLA
- Custom properties
- Bone constraints
- Retarget relations
- Replacement base body
I'll update the plan file to use these names throughout (operator ids, class names, and UI labels).
Tool use: **edit_file_v2** • Edit file: c:\Users\Nathan\.cursor\plans\per-step_migrator_operators_4986daf6.plan.md
Tool use: **edit_file_v2** • Edit file: c:\Users\Nathan\.cursor\plans\per-step_migrator_operators_4986daf6.plan.md
Tool use: **edit_file_v2** • Edit file: c:\Users\Nathan\.cursor\plans\per-step_migrator_operators_4986daf6.plan.md
Tool use: **edit_file_v2** • Edit file: c:\Users\Nathan\.cursor\plans\per-step_migrator_operators_4986daf6.plan.md
Thought Process
Fixed the typo in the plan - I had "utils__init__.py" in one place, should be "utils/__init__.py". Let me check if that's in the plan.
Tool use: **ripgrep_raw_search**
Parameters:
```json
{
"pattern": "utils",
"path": "c:\\Users\\Nathan\\.cursor\\plans\\per-step_migrator_operators_4986daf6.plan.md",
"caseInsensitive": false
}
```
Additional data:
```json
{
"isPruned": true,
"pattern": "utils",
"path": "c:\\Users\\Nathan\\.cursor\\plans\\per-step_migrator_operators_4986daf6.plan.md",
"outputMode": "content",
"totalFiles": 1,
"totalMatches": 1,
"topFiles": [
{
"uri": "c:\\Users\\Nathan\\.cursor\\plans\\per-step_migrator_operators_4986daf6.plan.md",
"matchCount": 1
}
]
}
```
Status: **completed**
---
Thought Process
There's a typo: utils__init__.py should be utils/__init__.py in the link. Let me fix that.
Tool use: **edit_file_v2** • Edit file: c:\Users\Nathan\.cursor\plans\per-step_migrator_operators_4986daf6.plan.md
Thought Process
Plan is updated. Summary for the user.
Thought Process
The user wants me to implement the per-step migrator operators plan. Let me check the todos and then implement:
1. Add six operators in ui/operators.py with the spec story names (copy_attributes, migrate_nla, custom_properties, bone_constraints, retarget_relations, replacement_base_body)
2. Change run_character_migration to invoke those six operators in order
3. Add six buttons in ui/panels.py
I'll start by reading the current operators and panels to implement the changes.
Tool use: **todo_write** • Todo List
- [-] Add six migrator step operators in ui/operators.py
- [ ] Change run_character_migration to invoke six operators
- [ ] Add six step buttons in CharMig panel
- [x] Migrator props and operators (run migration, pickers)
- [x] UI: CharMig section + Linked Libraries dropdown
- [x] Update blender_manifest.toml and __init__ registration
Tool use: **read_file_v2** • Read file: T:\Dynamic-Link-Manager\ui\operators.py
Tool use: **read_file_v2** • Read file: T:\Dynamic-Link-Manager\ui\operators.py
Thought Process
I need to:
1. Add a helper that gets (orig, rep) from context (used by all step operators)
2. Add six operator classes: DLM_OT_migrator_copy_attributes, DLM_OT_migrator_migrate_nla, DLM_OT_migrator_custom_properties, DLM_OT_migrator_bone_constraints, DLM_OT_migrator_retarget_relations, DLM_OT_migrator_replacement_base_body
3. Change DLM_OT_run_character_migration to call those six operators in order
4. Add the six to OPERATOR_CLASSES
5. Update panels to add the six buttons
Let me implement the six operators. Each one:
- Gets props, use_auto = props.migrator_mode, orig, rep = get_pair_automatic if use_auto else get_pair_manual
- If not orig or not rep or orig == rep: report error, return CANCELLED
- Try: call run_step_N (with orig_to_rep and rep_descendants for steps 4, 5, 6), report success, return FINISHED
- Except: report exception, return CANCELLED
Tool use: **edit_file_v2** • Edit file: T:\Dynamic-Link-Manager\ui\operators.py
Thought Process
I made a mistake - I left duplicate/broken code in run_character_migration. There was a loop that called migrator_copy_attributes 6 times, then I added the op_id_to_call dict and another loop. Let me fix run_character_migration to only have the single loop that calls each operator by id.
Tool use: **edit_file_v2** • Edit file: T:\Dynamic-Link-Manager\ui\operators.py
Thought Process
Now add the six operator classes to OPERATOR_CLASSES.
Tool use: **edit_file_v2** • Edit file: T:\Dynamic-Link-Manager\ui\operators.py
Thought Process
Now update the panel to add the six step buttons. Read the current CharMig section in panels.py.
Tool use: **todo_write** • Todo List
- [x] Add six migrator step operators in ui/operators.py
- [x] Change run_character_migration to invoke six operators
- [-] Add six step buttons in CharMig panel
- [x] Migrator props and operators (run migration, pickers)
- [x] UI: CharMig section + Linked Libraries dropdown
- [x] Update blender_manifest.toml and __init__ registration
Tool use: **read_file_v2** • Read file: T:\Dynamic-Link-Manager\ui\panels.py
Thought Process
I need to add the six step buttons after the "Run migration" button. Plan says: one row for "Run migration", then six buttons (row or column). I'll do one row for Run migration, then two rows of three step buttons to keep it compact.
Tool use: **edit_file_v2** • Edit file: T:\Dynamic-Link-Manager\ui\panels.py
Thought Process
Let me verify the operators - when calling bpy.ops.dlm.migrator_copy_attributes() from within another operator, Blender uses the current context. So we don't need to pass context. The return value of bpy.ops is a set like {'FINISHED'} or {'CANCELLED'}. So result != {"FINISHED"} is correct (we're comparing to a set literal).
Let me double-check: in Blender, bpy.ops.some_op() returns a set. So result = bpy.ops.dlm.migrator_copy_attributes() gives a set. Comparing with {"FINISHED"} should work. Good.
Read lints on the modified files.
Tool use: **read_lints**
Parameters:
```json
{
"paths": [
"T:\\Dynamic-Link-Manager\\ui\\operators.py",
"T:\\Dynamic-Link-Manager\\ui\\panels.py"
]
}
```
Result:
```json
{
"linterErrorsByFile": [
{
"relativeWorkspacePath": "T:\\Dynamic-Link-Manager\\ui\\operators.py"
},
{
"relativeWorkspacePath": "T:\\Dynamic-Link-Manager\\ui\\panels.py"
}
]
}
```
Status: **completed**
---
---
Thought Process
All good. Mark todo 3 as completed.
Tool use: **todo_write** • Todo List
- [x] Add six migrator step operators in ui/operators.py
- [x] Change run_character_migration to invoke six operators
- [x] Add six step buttons in CharMig panel
- [x] Migrator props and operators (run migration, pickers)
- [x] UI: CharMig section + Linked Libraries dropdown
- [x] Update blender_manifest.toml and __init__ registration
Thought Process
All tasks from the plan are done. Summary for the user.
Thought Process
The user is saying that the "replacement base body" step (step 6) does not create a library override on the replacement character's base body. I need to look at how step 6 is implemented in ops/migrator.py and fix it so it properly creates a library override on the base body mesh.
Let me search for the step 6 implementation and understand what's happening with the base body and library override.
Tool use: **ripgrep_raw_search**
Parameters:
```json
{
"pattern": "run_step_6|override_create|base.?body",
"path": "T:\\Dynamic-Link-Manager",
"glob": "*.py",
"caseInsensitive": false
}
```
Additional data:
```json
{
"isPruned": true,
"pattern": "run_step_6|override_create|base.?body",
"path": "T:\\Dynamic-Link-Manager",
"outputMode": "content",
"totalFiles": 3,
"totalMatches": 14,
"topFiles": [
{
"uri": "ops/migrator.py",
"matchCount": 4
},
{
"uri": "ui/operators.py",
"matchCount": 9
},
{
"uri": "ui/panels.py",
"matchCount": 1
}
]
}
```
Status: **completed**
---
Tool use: **read_file_v2** • Read file: T:\Dynamic-Link-Manager\ops\migrator.py
Thought Process
I need to see the full run_step_6 function to understand how it finds the base body and applies override. The grep showed ob.data.override_create() at line 170 - so it's calling override on mesh data. In Blender, library override can be on the object (id_data) or on the object's data. For a linked mesh object, we typically need to override the object so we can work with it in the current file. Let me read the full step 6.
Tool use: **read_file_v2** • Read file: T:\Dynamic-Link-Manager\ops\migrator.py
Thought Process
I see the issue. The code only calls `ob.data.override_create()` on the **mesh data** when the mesh data is linked or has an override. But:
1. In Blender, when you have a linked character, typically the **object** (the mesh object) is linked, not just the data. So we may need to call override on the **object** (`ob.override_create()`) to get a local override of the mesh object in the current file. If only the data is linked, then `ob.data.override_create()` would work for the data block.
2. The user said "does not create a library override on the repchar's basebody" - so the override is not being created. Possible causes:
- We're only checking/overriding `ob.data` (mesh data). If the **object** is linked (from a linked collection), we need to override the object. In Blender 3.0+, linked objects have `ob.library` or `ob.override_library`. So we should call `ob.override_create()` for the object when the object is linked, and optionally `ob.data.override_create()` when the data is linked.
- The condition `getattr(ob.data, "library", None) or getattr(ob.data, "override_library", None)` might be wrong: in Blender, the attribute for linked data is typically `.library` (the Library datablock it comes from). So if the mesh data is linked, we need to create an override. But if the **object** is linked, the object itself needs to be overridden first—you can't override just the data of a linked object from the current file; the object is in the linked file. So the flow should be: if the **object** is linked (ob.library), call ob.override_create(). If the **object's data** is linked (ob.data.library), call ob.data.override_create().
Let me check Blender API:
- For a linked object: `id.library` is set (the library it comes from).
- `override_create()` creates a library override in the current file.
So the fix should be:
1. If the **object** `ob` is linked (`getattr(ob, "library", None)`), call `ob.override_create()` so the object becomes an override in the current file.
2. If the **object's data** (mesh) is linked (`getattr(ob.data, "library", None)`), call `ob.data.override_create()`.
Actually re-reading the plan/spec: "for each replacement's base body mesh ... if mesh data is linked or override, call override_create() only (no single-user copy)."
So the spec says "mesh data" - but in practice, if the character is from a linked collection, the mesh *object* is often what's linked (the ob), and the ob.data might be shared or also linked. Creating an override on the object is usually what makes the instance editable in the current file; creating override on data makes the data block editable. For a mesh that's skinned to the armature, both the object and the data could be linked. So we should:
- If ob is linked: ob.override_create()
- If ob.data is linked: ob.data.override_create()
I'll add both so the base body object and its data get overridden when they're linked.
Tool use: **ripgrep_raw_search**
Parameters:
```json
{
"pattern": "library|override",
"path": "T:\\Dynamic-Link-Manager",
"glob": "*.py",
"caseInsensitive": false
}
```
Additional data:
```json
{
"isPruned": true,
"pattern": "library|override",
"path": "T:\\Dynamic-Link-Manager",
"outputMode": "content",
"totalFiles": 7,
"totalMatches": 46,
"topFiles": [
{
"uri": "ui/__init__.py",
"matchCount": 3
},
{
"uri": "ui/panels.py",
"matchCount": 3
},
{
"uri": "ui/properties.py",
"matchCount": 1
},
{
"uri": "ops/__init__.py",
"matchCount": 1
},
{
"uri": "ops/library.py",
"matchCount": 13
},
{
"uri": "ops/migrator.py",
"matchCount": 3
},
{
"uri": "ui/operators.py",
"matchCount": 22
}
]
}
```
Status: **completed**
---
Thought Process
So in Blender, `id.library` is set when the datablock is linked from a library. The replacement character's base body could be:
1. A mesh **object** that is linked (ob.library) - then we need ob.override_create()
2. The mesh **data** that is linked (ob.data.library) - then we need ob.data.override_create()
Currently step 6 only does ob.data.override_create(). If the mesh **object** is linked (which is common for linked characters - the whole hierarchy is linked), we need to override the object. So I'll add:
- If ob is linked: ob.override_create()
- If ob.data is linked: ob.data.override_create()
That way the rep character's base body object gets an override when it's linked.
Tool use: **edit_file_v2** • Edit file: T:\Dynamic-Link-Manager\ops\migrator.py
Thought Process
I removed the check for `override_library` - if it's already an override we don't need to call override_create again. So we only call override_create when the id is linked (.library is set). Good.
Thought Process
The user is saying that even after the fix, no library override is being created on the mesh data "CC_Base_Body.003". Let me look at the terminal output to see if there are any errors, and re-read the step 6 logic to understand what might be going wrong.
Possible issues:
1. The base body detection might not be finding this mesh (e.g. name doesn't contain both "body" and "base" in the right way?)
2. The mesh might not have an Armature modifier pointing at rep
3. override_create() might be failing silently (we have except: pass)
4. Maybe the mesh data has a different linked state - e.g. it could be that we need to override in a specific order or the API is different
Let me read the terminal file and the current step 6 code again.
Tool use: **read_file_v2** • Read file: c:\Users\Nathan\.cursor\projects\t-Dynamic-Link-Manager\terminals\3.txt
Tool use: **read_file_v2** • Read file: T:\Dynamic-Link-Manager\ops\migrator.py
Thought Process
The terminal doesn't show a Python exception. The mesh is "CC_Base_Body.003" - so the object name has "Base" and "Body", and the data might be named similarly. So the mesh should be found (name_lower would contain "body" and "base").
The issue might be:
1. **Blender override API**: In Blender, for mesh **data** that is linked, you might need to use a different approach. Let me check - maybe `override_create()` on ID only works in certain contexts, e.g. when the blend is in a certain state, or we need to use `bpy.ops.wm.lib_override_create()` (operator) instead of the method on the id.
2. **Order of operations**: Perhaps the object must be overridden first before we can override the data - and when we override the object, does the data automatically get overridden? Or maybe the mesh data is **instanced** by multiple objects (e.g. several CC_Base_Body.001, .002, .003) and they share the same mesh data - in that case the data might not be "linked" in the same way, or we need to override the data through the object.
3. **Blender docs**: In Blender 3.0+, library override: `id.override_create()` creates an override. But I've read that for some datablocks the override might need to be created via the operator `bpy.ops.wm.lib_override_create()` with the id passed. Let me search for how Blender creates overrides on mesh data.
Actually - re-reading the user message: "still no lib override created on **mesh data** CC_Base_Body.003". So they're talking about the mesh **data** (the Mesh datablock), not the object. So ob.data might be linked, and ob.data.override_create() is either not being called (ob.data.library is None?) or it's failing silently.
Possibilities:
A) The mesh **data** is not considered "linked" - e.g. it could be that in their setup the object is linked but the mesh data is already local (shared from the library but not marked as library?). Unlikely - usually both are linked.
B) ob.data.override_create() is failing (we have except: pass). So we swallow the error. I should at least log or report the error so we can see.
C) Blender might require using the operator bpy.ops.wm.lib_override_create() for override creation in some cases. Let me check the Blender Python API - in 4.2/5.0, ID.override_create() exists. But maybe for Mesh data we need to use the operator with context?
I'll search for Blender lib override create for mesh data.
Tool use: **web_search** • Searched web `undefined` • **1** results
| Title | URL | Chunk |
|-------|-----|-------|
| Web search results for query: Blender Python override_create mesh data lib_override ID.library | | Links:
1. [IDOverrideLibrary(bpy_struct) ¶](https://docs.blender.org/api/current/bpy.types.IDOverrideLibrary.html)
2. [Create Library Override of Data Block](https://blender.stackexchange.com/questions/177650/create-library-override-of-data-block/177657)
3. [Library Overrides ¶](https://developer.blender.org/docs/features/core/overrides/library/)
4. [Library Overrides API](https://projects.blender.org/blender/blender/issues/86656)
5. [Library Overrides ](https://docs.blender.org/manual/nb/3.0/files/linked_libraries/library_overrides.html)
# Blender Python Library Overrides: `override_create()` and Related Functions
## Creating a Library Override
To create a library override of mesh data in Blender Python, use the `override_create()` method on the ID (data-block):[2]
```python
obj = bpy.context.view_layer.objects.active
obj.data.override_create(remap_local_usages=True)
```
The method is available on any ID data structure and accepts parameters like `remap_local_usages` to control whether local usages of that linked ID should be remapped to the new override.[2]
## Related Library Override API Functions
Additional methods are available through `ID.override_library` for managing overrides:[4]
- `override_library.reset(hierarchy=True)`: Reset the library overrides structure
- `override_library.destroy(hierarchy=True)`: Remove the override structure and remap usages to linked IDs
- `override_library.operations_update()`: Update override operations to reflect current differences
- `override_library.properties.remove()`: Remove a specific override property
- `override_library.properties[x].operations.remove()`: Remove a specific override operation
## How Library Overrides Work
Library overrides create local, editable copies of linked data-blocks.[3] They track which parts were edited, allowing changes from the linked source to be merged with local overrides when files are reopened. Multiple independent overrides of the same linked data can exist, and overrides are stored in the `IDOverrideLibrary` structure at the ID level.[3] |
---
Tool use: **read_file_v2** • Read file: T:\Dynamic-Link-Manager\ops\migrator.py
Thought Process
The stackexchange link says we can use `obj.data.override_create(remap_local_usages=True)`. So the method exists. Maybe:
1. The mesh data isn't being detected as linked - e.g. in Blender 5 the attribute might be different, or the mesh could be instanced (same data block used by multiple objects from the library) so the data might not have .library set the way we expect.
2. We need to use the operator `bpy.ops.wm.lib_override_create()` instead - that might be the only way that works for nested datablocks.
Let me check the Blender operator for creating overrides - maybe we need to use the operator with the id_root set to the mesh data.
Tool use: **web_fetch**
Parameters:
```json
{
"url": "https://blender.stackexchange.com/questions/177650/create-library-override-of-data-block/177657"
}
```
Result:
```json
{
"url": "https://blender.stackexchange.com/questions/177650/create-library-override-of-data-block/177657",
"markdown": "# Create Library Override of Data Block\n\n- Tags: python, linked-data, data-blocks\n- Score: 2\n- Views: 1,020\n- Answers: 1\n- Asked by: Helmy (113 rep)\n- Asked on: May 9, 2020\n- Last active: May 9, 2020\n- License: CC BY-SA 4.0\n\n---\n\n## Question\n\nI want to access the \"create library override\" of a linked object in the data-block panel like shown in the image below via Python. When I do this, nothing appeared in the info panel. Is there any possible way to do this?\n\n[](https://i.sstatic.net/kVlrc.jpg)\n\n---\n\n## Answer 1 — Score: 3\n\n- By: Helmy (113 rep)\n- Answered on: May 9, 2020\n\nGot it:\n\n```\nobj = bpy.context.view_layer.objects.active\nobj.data.override_create(remap_local_usages=True)\n```\n\nAPI link: [https://docs.blender.org/api/current/bpy.types.ID.html#bpy.types.ID.override\\_create](https://docs.blender.org/api/current/bpy.types.ID.html#bpy.types.ID.override_create)"
}
```
User decision: **accepted**
Status: **completed**
---
Tool use: **ripgrep_raw_search**
Parameters:
```json
{
"pattern": "lib_override|override_create",
"path": "T:\\Dynamic-Link-Manager",
"caseInsensitive": false
}
```
Additional data:
```json
{
"isPruned": true,
"pattern": "lib_override|override_create",
"path": "T:\\Dynamic-Link-Manager",
"outputMode": "content",
"totalFiles": 4,
"totalMatches": 30,
"topFiles": [
{
"uri": ".specstory/history/2026-02-18_23-39Z-character-migrator-workflow-integration.md",
"matchCount": 13
},
{
"uri": "ops/migrator.py",
"matchCount": 2
},
{
"uri": "ops\\migrator.py",
"matchCount": 2
},
{
"uri": ".specstory\\history\\2026-02-18_23-39Z-character-migrator-workflow-integration.md",
"matchCount": 13
}
]
}
```
Status: **completed**
---
Thought Process
So the answer says obj.data.override_create(remap_local_usages=True). Maybe we need to pass remap_local_usages=True for it to work? Or maybe the issue is that when the **object** is overridden first (ob.override_create()), Blender might replace the object's data reference with the same linked data - so the data is still linked. So we must explicitly call ob.data.override_create() **after** the object override, and we need to pass remap_local_usages=True so that the new override data gets used.
Another possibility: in Blender, when you have a linked object that uses linked mesh data, calling ob.override_create() might only override the object, and the object's .data might still point to the linked mesh. So we need to call ob.data.override_create(remap_local_usages=True) to override the mesh data and have the object use the new override. So let me:
1. Always try to create override on mesh data when the data is linked (we already do this).
2. Use remap_local_usages=True as in the Blender answer.
3. Stop swallowing exceptions - at least log them so we can see if override_create is failing. Or we could report to the user.
Actually re-reading again: "still no lib override created on **mesh data** CC_Base_Body.003". So the mesh **data** name is CC_Base_Body.003 (or the object name). So the mesh data block is still linked. That could mean:
- ob.data.library is None in our code (e.g. we're iterating over the wrong objects, or the rep_descendants don't include this mesh, or the mesh data is shared and has a different link state)
- or override_create() is failing silently
Let me try:
1. Use the operator bpy.ops.wm.lib_override_create() - maybe that's the only reliable way. I need to check the operator signature.
2. Or call ob.data.override_create(remap_local_usages=True) and don't swallow exceptions - re-raise or report so we see the error.
Checking Blender 4.2/5.0 API: ID.override_create(remap_local_usages=False). So we could try remap_local_usages=True.
Also: maybe the mesh is found but it has no .library because in Blender 5 the mesh data might be shared across multiple linked object instances (e.g. CC_Base_Body, CC_Base_Body.001, CC_Base_Body.002, CC_Base_Body.003 - all might share one mesh data from the library). So ob.data could be the same Mesh datablock for several objects. That one mesh data would have .library set. So when we iterate rep_descendants we get one object that uses that data - and ob.data.library should be set. Unless... the object we're getting is already an override (we created ob.override_create() first), and when you override an object, does Blender create a new object that still references the same linked data? So after ob.override_create(), our `ob` might now be the override object, and ob.data might still be the linked mesh. So we need to call ob.data.override_create() - and that should work. Unless override_create on data requires something special.
Let me try:
1. Call ob.data.override_create(remap_local_usages=True) as in the Blender answer.
2. If the object was overridden first, the object's data pointer might need to be updated - remap_local_usages=True might do that.
3. Stop silencing exceptions: report the error so the user sees it, or use a print for debugging.
I'll add remap_local_usages=True and also try using the operator as a fallback. Let me check the operator.
Tool use: **web_search** • Searched web `undefined` • **1** results
| Title | URL | Chunk |
|-------|-----|-------|
| Web search results for query: Blender wm.lib_override_create operator Python id_root | | Links:
1. [IDOverrideLibraryPropertyOperations(bpy_struct) ¶](https://docs.blender.org/api/current/bpy.types.IDOverrideLibraryPropertyOperations.html)
2. [Wm Operators - Blender Python API](https://docs.blender.org/api/current/bpy.ops.wm.html)
3. [Library Overrides ¶](https://developer.blender.org/docs/features/core/overrides/library/)
4. [LibOverride: Make fully editable when creating an experimental user setting. · 7cfea48752](https://projects.blender.org/blender/blender/commit/7cfea48752ebc544104d57d19736c201a98bc3cd)
5. [Library Overrides API](https://projects.blender.org/blender/blender/issues/86656)
# Blender Library Override Creation with `wm.lib_override_create`
The `wm.lib_override_create` operator is part of Blender's library override system, which allows creating local, editable copies of linked datablocks.[3]
## Key Concepts
Library overrides are defined at the ID (datablock) level and support override hierarchies.[3] An override hierarchy is represented by a single 'root' datablock, with dependencies explicitly linked back to that root through a pointer.[3] The `id_root` parameter specifies this root datablock for the override hierarchy.
## API Structure
The library override system includes these key operations:[5]
- `override_hierarchy_create`: Create an override hierarchy
- `override_library.reset()`: Reset the override structure
- `override_library.destroy()`: Remove the override and remap usages
- `override_library.operations_update()`: Update operations to reflect differences between override and linked data
## Data Storage
Library overrides store override operations (not operands) in an `IDOverrideLibrary` structure, which contains:[3]
- A reference to the linked source ID
- A list of `IDOverrideLibraryProperty` structs
- Multiple `IDOverrideLibraryPropertyOperation` structs defining specific override operations
The actual data is stored in the local override ID itself, not in the override structure.[3] |
---
Tool use: **web_search** • Searched web `undefined` • **1** results
| Title | URL | Chunk |
|-------|-----|-------|
| Web search results for query: Blender ID override_create remap_local_usages mesh data | | Links:
1. [IDOverrideLibrary(bpy_struct) ¶](https://docs.blender.org/api/current/bpy.types.IDOverrideLibrary.html)
2. [Create Library Override of Data Block](https://blender.stackexchange.com/questions/177650/create-library-override-of-data-block/177657)
3. [Library Overrides API](https://projects.blender.org/blender/blender/issues/86656)
4. [Library Overrides ](https://docs.blender.org/manual/en/3.0/files/linked_libraries/library_overrides.html)
5. [Library Overrides ¶](https://developer.blender.org/docs/features/core/overrides/library/)
# Blender ID override_create with remap_local_usages for Mesh Data
The `override_create()` method is used to create library overrides for linked data-blocks in Blender. For mesh data specifically, you can use:[2]
```python
obj = bpy.context.view_layer.objects.active
obj.data.override_create(remap_local_usages=True)
```
## Key Parameters
**`remap_local_usages`**: When set to `True`, all local usages of the linked ID will be remapped to the new local override.[2] When set to `False` (default), only specific usages are remapped depending on where the override is created.[4]
## Usage Contexts
- **Single Data-Block Override** via Outliner context menu: Remaps **all** local usages of the linked ID to the override.[4]
- **Single Data-Block Override** via data-block UI menu (Shift-LMB on chain icon): Remaps only that specific usage to the override.[4]
## Related API
The `override_create()` method is part of `bpy.types.ID` and can be used on any linkable data-block type, including mesh data.[2][3] Additional override-related methods include `override_hierarchy_create()`, `override_library.reset()`, `override_library.destroy()`, and `override_library.operations_update()`.[3] |
---
Thought Process
So we should use ob.data.override_create(remap_local_usages=True). That might be what's missing - without remap_local_usages=True, the override might be created but the object might not be remapped to use it.
Also: maybe the issue is that we're only calling override_create when ob.data.library is set. What if the mesh data is **indirectly** linked (e.g. through the object's hierarchy) or has override_library already? Let me also try calling override_create when the data is linked OR when it's already an override that we need to ensure is created - actually no, if it's already an override we don't need to create. So the condition is: create override when ob.data is linked (ob.data.library).
One more possibility: when we have multiple objects sharing the same mesh data (CC_Base_Body, CC_Base_Body.001, ... all using one Mesh datablock), and we only iterate rep_descendants (descendants of the replacement armature), we might only get one of those objects - the one that is under the rep hierarchy. So we find that object, and ob.data is the shared mesh. That mesh could be linked. So we call ob.data.override_create(remap_local_usages=True). The remap_local_usages=True would remap all local usages of that linked mesh to the new override - so all objects in the current file that use that mesh would now use the override. That should work.
Let me update the code to:
1. Use remap_local_usages=True when calling ob.data.override_create().
2. Optionally: ensure we also run override_create on the object first when the object is linked (we already do that). Order: object first, then data - so the object override exists and points to the linked data; then we override the data with remap_local_usages=True so the object (and any other users) get the new override data.
3. Stop silencing exceptions - report or re-raise so we see failures. I'll use a try/except that reports the error with self.report in the operator - but run_step_6 doesn't have self. We could let the exception propagate so the operator's try/except catches it and reports. So I'll remove the bare `except: pass` and let it propagate, OR we could add a report callback. Simpler: just use remap_local_usages=True and if it still fails we don't swallow - actually the migrator doesn't have access to report. So the operator that calls run_step_6 has try/except and reports. So if we don't pass in run_step_6, the exception will propagate to the operator and get reported. So I'll remove the try/except in run_step_6 and use remap_local_usages=True - then any failure will be visible. Let me keep a try/except but re-raise so the operator sees it: `except Exception as e: raise` or just remove try/except.
Tool use: **edit_file_v2** • Edit file: T:\Dynamic-Link-Manager\ops\migrator.py
Thought Process
If the mesh data still doesn't get overridden, the issue might be that we're not finding the mesh (e.g. "CC_Base_Body.003" - maybe the object name is that and the data name is different, and our name check might fail?). Or the mesh might be used only by an object that isn't in rep_descendants. Let me re-read the filter: we require "body" and "base" in name_lower (ob.name + " " + ob.data.name). "CC_Base_Body.003" has "base" and "body", so we're good.
Another possibility: in Blender, when the **object** is linked and we call ob.override_create(), the new override object might be a different object - and we're still iterating with the old `ob` reference. So after ob.override_create(), does `ob` get updated in place to be the override, or does Blender replace it? In Blender's override system, override_create() typically works in place - the ID becomes an override. So `ob` should still be valid and now be an override. And ob.data might still point to the linked mesh until we call ob.data.override_create(remap_local_usages=True).
One more thing: maybe the mesh data is not "linked" in the sense of having .library - e.g. it could be that the mesh data is instanced from the library by multiple objects and the data block in the current file is considered "local" but is a direct reference to the library data? I'm not 100% sure of Blender's internal behavior. Let me also try using the operator bpy.ops.wm.lib_override_create() with id_root=ob.data - that might be the more reliable way to create overrides on nested datablocks. Let me check the operator signature in the docs.
Tool use: **web_fetch**
Parameters:
```json
{
"url": "https://docs.blender.org/api/current/bpy.ops.wm.html"
}
```
Result:
```json
{
"url": "https://docs.blender.org/api/current/bpy.ops.wm.html",
"markdown": "Wm Operators - Blender Python API\n\n# Wm Operators¶\n\nbpy.ops.wm.alembic_export(*, filepath='', check_existing=True, filter_blender=False, filter_backup=False, filter_image=False, filter_movie=False, filter_python=False, filter_font=False, filter_sound=False, filter_text=False, filter_archive=False, filter_btx=False, filter_alembic=True, filter_usd=False, filter_obj=False, filter_volume=False, filter_folder=True, filter_blenlib=False, filemode=8, display_type='DEFAULT', sort_method='', filter_glob='*.abc', start=-2147483648, end=-2147483648, xsamples=1, gsamples=1, sh_open=0.0, sh_close=1.0, selected=False, flatten=False, collection='', uvs=True, packuv=True, normals=True, vcolors=False, orcos=True, face_sets=False, subdiv_schema=False, apply_subdiv=False, curves_as_mesh=False, use_instancing=True, global_scale=1.0, triangulate=False, quad_method='SHORTEST_DIAGONAL', ngon_method='BEAUTY', export_hair=True, export_particles=True, export_custom_properties=True, as_background_job=False, evaluation_mode='RENDER', init_scene_frame_range=True)¶\n\nExport current scene in an Alembic archive\n\nParameters:\n\nfilepath (string, (optional, never None)) – File Path, Path to file\n\ncheck_existing (boolean, (optional)) – Check Existing, Check and warn on overwriting existing files\n\nfilter_blender (boolean, (optional)) – Filter .blend files\n\nfilter_backup (boolean, (optional)) – Filter .blend files\n\nfilter_image (boolean, (optional)) – Filter image files\n\nfilter_movie (boolean, (optional)) – Filter movie files\n\nfilter_python (boolean, (optional)) – Filter Python files\n\nfilter_font (boolean, (optional)) – Filter font files\n\nfilter_sound (boolean, (optional)) – Filter sound files\n\nfilter_text (boolean, (optional)) – Filter text files\n\nfilter_archive (boolean, (optional)) – Filter archive files\n\nfilter_btx (boolean, (optional)) – Filter btx files\n\nfilter_alembic (boolean, (optional)) – Filter Alembic files\n\nfilter_usd (boolean, (optional)) – Filter USD files\n\nfilter_obj (boolean, (optional)) – Filter OBJ files\n\nfilter_volume (boolean, (optional)) – Filter OpenVDB volume files\n\nfilter_folder (boolean, (optional)) – Filter folders\n\nfilter_blenlib (boolean, (optional)) – Filter Blender IDs\n\nfilemode (int in [1, 9], (optional)) – File Browser Mode, The setting for the file browser mode to load a .blend file, a library or a special file\n\ndisplay_type (enum in [`'DEFAULT'`,`'LIST_VERTICAL'`,`'LIST_HORIZONTAL'`,`'THUMBNAIL'`], (optional)) –\n\nDisplay Type\n\n`DEFAULT` Default – Automatically determine display type for files.\n\n`LIST_VERTICAL` Short List – Display files as short list.\n\n`LIST_HORIZONTAL` Long List – Display files as a detailed list.\n\n`THUMBNAIL` Thumbnails – Display files as thumbnails.\n\nsort_method (enum in [], (optional)) – File sorting mode\n\nstart (int in [-inf, inf], (optional)) – Start Frame, Start frame of the export, use the default value to take the start frame of the current scene\n\nend (int in [-inf, inf], (optional)) – End Frame, End frame of the export, use the default value to take the end frame of the current scene\n\nxsamples (int in [1, 128], (optional)) – Transform Samples, Number of times per frame transformations are sampled\n\ngsamples (int in [1, 128], (optional)) – Geometry Samples, Number of times per frame object data are sampled\n\nsh_open (float in [-1, 1], (optional)) – Shutter Open, Time at which the shutter is open\n\nsh_close (float in [-1, 1], (optional)) – Shutter Close, Time at which the shutter is closed\n\nselected (boolean, (optional)) – Selected Objects Only, Export only selected objects\n\nflatten (boolean, (optional)) – Flatten Hierarchy, Do not preserve objects’ parent/children relationship\n\ncollection (string, (optional, never None)) – Collection\n\nuvs (boolean, (optional)) – UV Coordinates, Export UV coordinates\n\npackuv (boolean, (optional)) – Merge UVs\n\nnormals (boolean, (optional)) – Normals, Export normals\n\nvcolors (boolean, (optional)) – Color Attributes, Export color attributes\n\norcos (boolean, (optional)) – Generated Coordinates, Export undeformed mesh vertex coordinates\n\nface_sets (boolean, (optional)) – Face Sets, Export per face shading group assignments\n\nsubdiv_schema (boolean, (optional)) – Use Subdivision Schema, Export meshes using Alembic’s subdivision schema\n\napply_subdiv (boolean, (optional)) – Apply Subdivision Surface, Export subdivision surfaces as meshes\n\ncurves_as_mesh (boolean, (optional)) – Curves as Mesh, Export curves and NURBS surfaces as meshes\n\nuse_instancing (boolean, (optional)) – Use Instancing, Export data of duplicated objects as Alembic instances; speeds up the export and can be disabled for compatibility with other software\n\nglobal_scale (float in [0.0001, 1000], (optional)) – Scale, Value by which to enlarge or shrink the objects with respect to the world’s origin\n\ntriangulate (boolean, (optional)) – Triangulate, Export polygons (quads and n-gons) as triangles\n\nquad_method (enum in [Modifier Triangulate Quad Method Items](https://docs.blender.org/api/current/bpy_types_enum_items/modifier_triangulate_quad_method_items.html#rna-enum-modifier-triangulate-quad-method-items), (optional)) – Quad Method, Method for splitting the quads into triangles\n\nngon_method (enum in [Modifier Triangulate Ngon Method Items](https://docs.blender.org/api/current/bpy_types_enum_items/modifier_triangulate_ngon_method_items.html#rna-enum-modifier-triangulate-ngon-method-items), (optional)) – N-gon Method, Method for splitting the n-gons into triangles\n\nexport_hair (boolean, (optional)) – Export Hair, Exports hair particle systems as animated curves\n\nexport_particles (boolean, (optional)) – Export Particles, Exports non-hair particle systems\n\nexport_custom_properties (boolean, (optional)) – Export Custom Properties, Export custom properties to Alembic .userProperties\n\nas_background_job (boolean, (optional)) – Run as Background Job, Enable this to run the import in the background, disable to block Blender while importing. This option is deprecated; EXECUTE this operator to run in the foreground, and INVOKE it to run as a background job\n\nevaluation_mode (enum in [`'RENDER'`,`'VIEWPORT'`], (optional)) –\n\nSettings, Determines visibility of objects, modifier settings, and other areas where there are different settings for viewport and rendering\n\n`RENDER` Render – Use Render settings for object visibility, modifier settings, etc.\n\n`VIEWPORT` Viewport – Use Viewport settings for object visibility, modifier settings, etc.\n\nbpy.ops.wm.alembic_import(*, filepath='', directory='', files=None, check_existing=False, filter_blender=False, filter_backup=False, filter_image=False, filter_movie=False, filter_python=False, filter_font=False, filter_sound=False, filter_text=False, filter_archive=False, filter_btx=False, filter_alembic=True, filter_usd=False, filter_obj=False, filter_volume=False, filter_folder=True, filter_blenlib=False, filemode=8, relative_path=True, display_type='DEFAULT', sort_method='', filter_glob='*.abc', scale=1.0, set_frame_range=True, validate_meshes=False, always_add_cache_reader=False, is_sequence=False, as_background_job=False)¶\n\nLoad an Alembic archive\n\nParameters:\n\nfilepath (string, (optional, never None)) – File Path, Path to file\n\ndirectory (string, (optional, never None)) – Directory, Directory of the file\n\nfiles (`bpy_prop_collection` of`OperatorFileListElement`, (optional)) – Files\n\ncheck_existing (boolean, (optional)) – Check Existing, Check and warn on overwriting existing files\n\nfilter_blender (boolean, (optional)) – Filter .blend files\n\nfilter_backup (boolean, (optional)) – Filter .blend files\n\nfilter_image (boolean, (optional)) – Filter image files\n\nfilter_movie (boolean, (optional)) – Filter movie files\n\nfilter_python (boolean, (optional)) – Filter Python files\n\nfilter_font (boolean, (optional)) – Filter font files\n\nfilter_sound (boolean, (optional)) – Filter sound files\n\nfilter_text (boolean, (optional)) – Filter text files\n\nfilter_archive (boolean, (optional)) – Filter archive files\n\nfilter_btx (boolean, (optional)) – Filter btx files\n\nfilter_alembic (boolean, (optional)) – Filter Alembic files\n\nfilter_usd (boolean, (optional)) – Filter USD files\n\nfilter_obj (boolean, (optional)) – Filter OBJ files\n\nfilter_volume (boolean, (optional)) – Filter OpenVDB volume files\n\nfilter_folder (boolean, (optional)) – Filter folders\n\nfilter_blenlib (boolean, (optional)) – Filter Blender IDs\n\nfilemode (int in [1, 9], (optional)) – File Browser Mode, The setting for the file browser mode to load a .blend file, a library or a special file\n\nrelative_path (boolean, (optional)) – Relative Path, Select the file relative to the blend file\n\ndisplay_type (enum in [`'DEFAULT'`,`'LIST_VERTICAL'`,`'LIST_HORIZONTAL'`,`'THUMBNAIL'`], (optional)) –\n\nDisplay Type\n\n`DEFAULT` Default – Automatically determine display type for files.\n\n`LIST_VERTICAL` Short List – Display files as short list.\n\n`LIST_HORIZONTAL` Long List – Display files as a detailed list.\n\n`THUMBNAIL` Thumbnails – Display files as thumbnails.\n\nsort_method (enum in [], (optional)) – File sorting mode\n\nscale (float in [0.0001, 1000], (optional)) – Scale, Value by which to enlarge or shrink the objects with respect to the world’s origin\n\nset_frame_range (boolean, (optional)) – Set Frame Range, If checked, update scene’s start and end frame to match those of the Alembic archive\n\nvalidate_meshes (boolean, (optional)) – Validate Meshes, Ensure the data is valid (when disabled, data may be imported which causes crashes displaying or editing)\n\nalways_add_cache_reader (boolean, (optional)) – Always Add Cache Reader, Add cache modifiers and constraints to imported objects even if they are not animated so that they can be updated when reloading the Alembic archive\n\nis_sequence (boolean, (optional)) – Is Sequence, Set to true if the cache is split into separate files\n\nas_background_job (boolean, (optional)) – Run as Background Job, Enable this to run the export in the background, disable to block Blender while exporting. This option is deprecated; EXECUTE this operator to run in the foreground, and INVOKE it to run as a background job\n\nbpy.ops.wm.append(*, filepath='', directory='', filename='', files=None, check_existing=False, filter_blender=True, filter_backup=False, filter_image=False, filter_movie=False, filter_python=False, filter_font=False, filter_sound=False, filter_text=False, filter_archive=False, filter_btx=False, filter_alembic=False, filter_usd=False, filter_obj=False, filter_volume=False, filter_folder=True, filter_blenlib=True, filemode=1, display_type='DEFAULT', sort_method='', link=False, do_reuse_local_id=False, clear_asset_data=False, autoselect=True, active_collection=True, instance_collections=False, instance_object_data=True, set_fake=False, use_recursive=True)¶\n\nAppend from a Library .blend file\n\nParameters:\n\nfilepath (string, (optional, never None)) – File Path, Path to file\n\ndirectory (string, (optional, never None)) – Directory, Directory of the file\n\nfilename (string, (optional, never None)) – File Name, Name of the file\n\nfiles (`bpy_prop_collection` of`OperatorFileListElement`, (optional)) – Files\n\ncheck_existing (boolean, (optional)) – Check Existing, Check and warn on overwriting existing files\n\nfilter_blender (boolean, (optional)) – Filter .blend files\n\nfilter_backup (boolean, (optional)) – Filter .blend files\n\nfilter_image (boolean, (optional)) – Filter image files\n\nfilter_movie (boolean, (optional)) – Filter movie files\n\nfilter_python (boolean, (optional)) – Filter Python files\n\nfilter_font (boolean, (optional)) – Filter font files\n\nfilter_sound (boolean, (optional)) – Filter sound files\n\nfilter_text (boolean, (optional)) – Filter text files\n\nfilter_archive (boolean, (optional)) – Filter archive files\n\nfilter_btx (boolean, (optional)) – Filter btx files\n\nfilter_alembic (boolean, (optional)) – Filter Alembic files\n\nfilter_usd (boolean, (optional)) – Filter USD files\n\nfilter_obj (boolean, (optional)) – Filter OBJ files\n\nfilter_volume (boolean, (optional)) – Filter OpenVDB volume files\n\nfilter_folder (boolean, (optional)) – Filter folders\n\nfilter_blenlib (boolean, (optional)) – Filter Blender IDs\n\nfilemode (int in [1, 9], (optional)) – File Browser Mode, The setting for the file browser mode to load a .blend file, a library or a special file\n\ndisplay_type (enum in [`'DEFAULT'`,`'LIST_VERTICAL'`,`'LIST_HORIZONTAL'`,`'THUMBNAIL'`], (optional)) –\n\nDisplay Type\n\n`DEFAULT` Default – Automatically determine display type for files.\n\n`LIST_VERTICAL` Short List – Display files as short list.\n\n`LIST_HORIZONTAL` Long List – Display files as a detailed list.\n\n`THUMBNAIL` Thumbnails – Display files as thumbnails.\n\nsort_method (enum in [], (optional)) – File sorting mode\n\nlink (boolean, (optional)) – Link, Link the objects or data-blocks rather than appending\n\ndo_reuse_local_id (boolean, (optional)) – Re-Use Local Data, Try to re-use previously matching appended data-blocks instead of appending a new copy\n\nclear_asset_data (boolean, (optional)) – Clear Asset Data, Don’t add asset meta-data or tags from the original data-block\n\nautoselect (boolean, (optional)) – Select, Select new objects\n\nactive_collection (boolean, (optional)) – Active Collection, Put new objects on the active collection\n\ninstance_collections (boolean, (optional)) – Instance Collections, Create instances for collections, rather than adding them directly to the scene\n\ninstance_object_data (boolean, (optional)) – Instance Object Data, Create instances for object data which are not referenced by any objects\n\nset_fake (boolean, (optional)) – Fake User, Set “Fake User” for appended items (except objects and collections)\n\nuse_recursive (boolean, (optional)) – Localize All, Localize all appended data, including those indirectly linked from other libraries\n\nbpy.ops.wm.batch_rename(*, data_type='OBJECT', data_source='SELECT', actions=None)¶\n\nRename multiple items at once\n\nParameters:\n\ndata_type (enum in [`'OBJECT'`,`'COLLECTION'`,`'MATERIAL'`,`'MESH'`,`'CURVE'`,`'META'`,`'VOLUME'`,`'GREASEPENCIL'`,`'ARMATURE'`,`'LATTICE'`,`'LIGHT'`,`'LIGHT_PROBE'`,`'CAMERA'`,`'SPEAKER'`,`'BONE'`,`'NODE'`,`'SEQUENCE_STRIP'`,`'ACTION_CLIP'`,`'SCENE'`,`'BRUSH'`], (optional)) – Type, Type of data to rename\n\ndata_source (enum in [`'SELECT'`,`'ALL'`], (optional)) – Source\n\nactions (`bpy_prop_collection` of`BatchRenameAction`, (optional)) – actions\n\nFile:\n\n[startup/bl_operators/wm.py:3280](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_operators/wm.py#L3280)\n\nbpy.ops.wm.blend_strings_utf8_validate()¶\n\nCheck and fix all strings in current .blend file to be valid UTF-8 Unicode (needed for some old, 2.4x area files)\n\nFile:\n\n[startup/bl_operators/file.py:289](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_operators/file.py#L289)\n\nbpy.ops.wm.call_asset_shelf_popover(*, name='')¶\n\nOpen a predefined asset shelf in a popup\n\nParameters:\n\nname (string, (optional, never None)) – Asset Shelf Name, Identifier of the asset shelf to display\n\nbpy.ops.wm.call_menu(*, name='')¶\n\nOpen a predefined menu\n\nParameters:\n\nname (string, (optional, never None)) – Name, Name of the menu\n\nbpy.ops.wm.call_menu_pie(*, name='')¶\n\nOpen a predefined pie menu\n\nParameters:\n\nname (string, (optional, never None)) – Name, Name of the pie menu\n\nbpy.ops.wm.call_panel(*, name='', keep_open=True)¶\n\nOpen a predefined panel\n\nParameters:\n\nname (string, (optional, never None)) – Name, Name of the menu\n\nkeep_open (boolean, (optional)) – Keep Open\n\nbpy.ops.wm.clear_recent_files(*, remove='ALL')¶\n\nClear the recent files list\n\nParameters:\n\nremove (enum in [`'ALL'`,`'MISSING'`], (optional)) – Remove\n\nbpy.ops.wm.collection_export_all()¶\n\nInvoke all configured exporters for all collections\n\nbpy.ops.wm.context_collection_boolean_set(*, data_path_iter='', data_path_item='', type='TOGGLE')¶\n\nSet boolean values for a collection of items\n\nParameters:\n\ndata_path_iter (string, (optional, never None)) – data_path_iter, The data path relative to the context, must point to an iterable\n\ndata_path_item (string, (optional, never None)) – data_path_item, The data path from each iterable to the value (int or float)\n\ntype (enum in [`'TOGGLE'`,`'ENABLE'`,`'DISABLE'`], (optional)) – Type\n\nFile:\n\n[startup/bl_operators/wm.py:875](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_operators/wm.py#L875)\n\nbpy.ops.wm.context_cycle_array(*, data_path='', reverse=False)¶\n\nSet a context array value (useful for cycling the active mesh edit mode)\n\nParameters:\n\ndata_path (string, (optional, never None)) – Context Attributes, Context data-path (expanded using visible windows in the current .blend file)\n\nreverse (boolean, (optional)) – Reverse, Cycle backwards\n\nFile:\n\n[startup/bl_operators/wm.py:673](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_operators/wm.py#L673)\n\nbpy.ops.wm.context_cycle_enum(*, data_path='', reverse=False, wrap=False)¶\n\nToggle a context value\n\nParameters:\n\ndata_path (string, (optional, never None)) – Context Attributes, Context data-path (expanded using visible windows in the current .blend file)\n\nreverse (boolean, (optional)) – Reverse, Cycle backwards\n\nwrap (boolean, (optional)) – Wrap, Wrap back to the first/last values\n\nFile:\n\n[startup/bl_operators/wm.py:624](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_operators/wm.py#L624)\n\nbpy.ops.wm.context_cycle_int(*, data_path='', reverse=False, wrap=False)¶\n\nSet a context value (useful for cycling active material, shape keys, groups, etc.)\n\nParameters:\n\ndata_path (string, (optional, never None)) – Context Attributes, Context data-path (expanded using visible windows in the current .blend file)\n\nreverse (boolean, (optional)) – Reverse, Cycle backwards\n\nwrap (boolean, (optional)) – Wrap, Wrap back to the first/last values\n\nFile:\n\n[startup/bl_operators/wm.py:584](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_operators/wm.py#L584)\n\nbpy.ops.wm.context_menu_enum(*, data_path='')¶\n\nUndocumented, consider [contributing](https://developer.blender.org/).\n\nParameters:\n\ndata_path (string, (optional, never None)) – Context Attributes, Context data-path (expanded using visible windows in the current .blend file)\n\nFile:\n\n[startup/bl_operators/wm.py:703](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_operators/wm.py#L703)\n\nbpy.ops.wm.context_modal_mouse(*, data_path_iter='', data_path_item='', header_text='', input_scale=0.01, invert=False, initial_x=0)¶\n\nAdjust arbitrary values with mouse input\n\nParameters:\n\ndata_path_iter (string, (optional, never None)) – data_path_iter, The data path relative to the context, must point to an iterable\n\ndata_path_item (string, (optional, never None)) – data_path_item, The data path from each iterable to the value (int or float)\n\nheader_text (string, (optional, never None)) – Header Text, Text to display in header during scale\n\ninput_scale (float in [-inf, inf], (optional)) – input_scale, Scale the mouse movement by this value before applying the delta\n\ninvert (boolean, (optional)) – invert, Invert the mouse input\n\ninitial_x (int in [-inf, inf], (optional)) – initial_x\n\nFile:\n\n[startup/bl_operators/wm.py:1014](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_operators/wm.py#L1014)\n\nbpy.ops.wm.context_pie_enum(*, data_path='')¶\n\nUndocumented, consider [contributing](https://developer.blender.org/).\n\nParameters:\n\ndata_path (string, (optional, never None)) – Context Attributes, Context data-path (expanded using visible windows in the current .blend file)\n\nFile:\n\n[startup/bl_operators/wm.py:735](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_operators/wm.py#L735)\n\nbpy.ops.wm.context_scale_float(*, data_path='', value=1.0)¶\n\nScale a float context value\n\nParameters:\n\ndata_path (string, (optional, never None)) – Context Attributes, Context data-path (expanded using visible windows in the current .blend file)\n\nvalue (float in [-inf, inf], (optional)) – Value, Assign value\n\nFile:\n\n[startup/bl_operators/wm.py:338](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_operators/wm.py#L338)\n\nbpy.ops.wm.context_scale_int(*, data_path='', value=1.0, always_step=True)¶\n\nScale an int context value\n\nParameters:\n\ndata_path (string, (optional, never None)) – Context Attributes, Context data-path (expanded using visible windows in the current .blend file)\n\nvalue (float in [-inf, inf], (optional)) – Value, Assign value\n\nalways_step (boolean, (optional)) – Always Step, Always adjust the value by a minimum of 1 when ‘value’ is not 1.0\n\nFile:\n\n[startup/bl_operators/wm.py:376](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_operators/wm.py#L376)\n\nbpy.ops.wm.context_set_boolean(*, data_path='', value=True)¶\n\nSet a context value\n\nParameters:\n\ndata_path (string, (optional, never None)) – Context Attributes, Context data-path (expanded using visible windows in the current .blend file)\n\nvalue (boolean, (optional)) – Value, Assignment value\n\nFile:\n\n[startup/bl_operators/wm.py:267](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_operators/wm.py#L267)\n\nbpy.ops.wm.context_set_enum(*, data_path='', value='')¶\n\nSet a context value\n\nParameters:\n\ndata_path (string, (optional, never None)) – Context Attributes, Context data-path (expanded using visible windows in the current .blend file)\n\nvalue (string, (optional, never None)) – Value, Assignment value (as a string)\n\nFile:\n\n[startup/bl_operators/wm.py:267](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_operators/wm.py#L267)\n\nbpy.ops.wm.context_set_float(*, data_path='', value=0.0, relative=False)¶\n\nSet a context value\n\nParameters:\n\ndata_path (string, (optional, never None)) – Context Attributes, Context data-path (expanded using visible windows in the current .blend file)\n\nvalue (float in [-inf, inf], (optional)) – Value, Assignment value\n\nrelative (boolean, (optional)) – Relative, Apply relative to the current value (delta)\n\nFile:\n\n[startup/bl_operators/wm.py:267](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_operators/wm.py#L267)\n\nbpy.ops.wm.context_set_id(*, data_path='', value='')¶\n\nSet a context value to an ID data-block\n\nParameters:\n\ndata_path (string, (optional, never None)) – Context Attributes, Context data-path (expanded using visible windows in the current .blend file)\n\nvalue (string, (optional, never None)) – Value, Assign value\n\nFile:\n\n[startup/bl_operators/wm.py:817](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_operators/wm.py#L817)\n\nbpy.ops.wm.context_set_int(*, data_path='', value=0, relative=False)¶\n\nSet a context value\n\nParameters:\n\ndata_path (string, (optional, never None)) – Context Attributes, Context data-path (expanded using visible windows in the current .blend file)\n\nvalue (int in [-inf, inf], (optional)) – Value, Assign value\n\nrelative (boolean, (optional)) – Relative, Apply relative to the current value (delta)\n\nFile:\n\n[startup/bl_operators/wm.py:267](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_operators/wm.py#L267)\n\nbpy.ops.wm.context_set_string(*, data_path='', value='')¶\n\nSet a context value\n\nParameters:\n\ndata_path (string, (optional, never None)) – Context Attributes, Context data-path (expanded using visible windows in the current .blend file)\n\nvalue (string, (optional, never None)) – Value, Assign value\n\nFile:\n\n[startup/bl_operators/wm.py:267](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_operators/wm.py#L267)\n\nbpy.ops.wm.context_set_value(*, data_path='', value='')¶\n\nSet a context value\n\nParameters:\n\ndata_path (string, (optional, never None)) – Context Attributes, Context data-path (expanded using visible windows in the current .blend file)\n\nvalue (string, (optional, never None)) – Value, Assignment value (as a string)\n\nFile:\n\n[startup/bl_operators/wm.py:480](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_operators/wm.py#L480)\n\nbpy.ops.wm.context_toggle(*, data_path='', module='')¶\n\nToggle a context value\n\nParameters:\n\ndata_path (string, (optional, never None)) – Context Attributes, Context data-path (expanded using visible windows in the current .blend file)\n\nmodule (string, (optional, never None)) – Module, Optionally override the context with a module\n\nFile:\n\n[startup/bl_operators/wm.py:504](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_operators/wm.py#L504)\n\nbpy.ops.wm.context_toggle_enum(*, data_path='', value_1='', value_2='')¶\n\nToggle a context value\n\nParameters:\n\ndata_path (string, (optional, never None)) – Context Attributes, Context data-path (expanded using visible windows in the current .blend file)\n\nvalue_1 (string, (optional, never None)) – Value, Toggle enum\n\nvalue_2 (string, (optional, never None)) – Value, Toggle enum\n\nFile:\n\n[startup/bl_operators/wm.py:545](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_operators/wm.py#L545)\n\nbpy.ops.wm.debug_menu(*, debug_value=0)¶\n\nOpen a popup to set the debug level\n\nParameters:\n\ndebug_value (int in [-32768, 32767], (optional)) – Debug Value\n\nbpy.ops.wm.doc_view(*, doc_id='')¶\n\nOpen online reference docs in a web browser\n\nParameters:\n\ndoc_id (string, (optional, never None)) – Doc ID\n\nFile:\n\n[startup/bl_operators/wm.py:1361](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_operators/wm.py#L1361)\n\nbpy.ops.wm.doc_view_manual(*, doc_id='')¶\n\nLoad online manual\n\nParameters:\n\ndoc_id (string, (optional, never None)) – Doc ID\n\nFile:\n\n[startup/bl_operators/wm.py:1334](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_operators/wm.py#L1334)\n\nbpy.ops.wm.doc_view_manual_ui_context()¶\n\nView a context based online manual in a web browser\n\nbpy.ops.wm.drop_blend_file(*, filepath='')¶\n\nUndocumented, consider [contributing](https://developer.blender.org/).\n\nParameters:\n\nfilepath (string, (optional, never None)) – filepath\n\nFile:\n\n[startup/bl_operators/wm.py:3655](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_operators/wm.py#L3655)\n\nbpy.ops.wm.drop_import_file(*, directory='', files=None)¶\n\nOperator that allows file handlers to receive file drops\n\nParameters:\n\ndirectory (string, (optional, never None)) – Directory, Directory of the file\n\nfiles (`bpy_prop_collection` of`OperatorFileListElement`, (optional)) – Files\n\nbpy.ops.wm.fbx_import(*, filepath='', directory='', files=None, check_existing=False, filter_blender=False, filter_backup=False, filter_image=False, filter_movie=False, filter_python=False, filter_font=False, filter_sound=False, filter_text=False, filter_archive=False, filter_btx=False, filter_alembic=False, filter_usd=False, filter_obj=False, filter_volume=False, filter_folder=True, filter_blenlib=False, filemode=8, display_type='DEFAULT', sort_method='', global_scale=1.0, mtl_name_collision_mode='MAKE_UNIQUE', import_colors='SRGB', use_custom_normals=True, use_custom_props=True, use_custom_props_enum_as_string=True, import_subdivision=False, ignore_leaf_bones=False, validate_meshes=True, use_anim=True, anim_offset=1.0, filter_glob='*.fbx')¶\n\nImport FBX file into current scene\n\nParameters:\n\nfilepath (string, (optional, never None)) – File Path, Path to file\n\ndirectory (string, (optional, never None)) – Directory, Directory of the file\n\nfiles (`bpy_prop_collection` of`OperatorFileListElement`, (optional)) – Files\n\ncheck_existing (boolean, (optional)) – Check Existing, Check and warn on overwriting existing files\n\nfilter_blender (boolean, (optional)) – Filter .blend files\n\nfilter_backup (boolean, (optional)) – Filter .blend files\n\nfilter_image (boolean, (optional)) – Filter image files\n\nfilter_movie (boolean, (optional)) – Filter movie files\n\nfilter_python (boolean, (optional)) – Filter Python files\n\nfilter_font (boolean, (optional)) – Filter font files\n\nfilter_sound (boolean, (optional)) – Filter sound files\n\nfilter_text (boolean, (optional)) – Filter text files\n\nfilter_archive (boolean, (optional)) – Filter archive files\n\nfilter_btx (boolean, (optional)) – Filter btx files\n\nfilter_alembic (boolean, (optional)) – Filter Alembic files\n\nfilter_usd (boolean, (optional)) – Filter USD files\n\nfilter_obj (boolean, (optional)) – Filter OBJ files\n\nfilter_volume (boolean, (optional)) – Filter OpenVDB volume files\n\nfilter_folder (boolean, (optional)) – Filter folders\n\nfilter_blenlib (boolean, (optional)) – Filter Blender IDs\n\nfilemode (int in [1, 9], (optional)) – File Browser Mode, The setting for the file browser mode to load a .blend file, a library or a special file\n\ndisplay_type (enum in [`'DEFAULT'`,`'LIST_VERTICAL'`,`'LIST_HORIZONTAL'`,`'THUMBNAIL'`], (optional)) –\n\nDisplay Type\n\n`DEFAULT` Default – Automatically determine display type for files.\n\n`LIST_VERTICAL` Short List – Display files as short list.\n\n`LIST_HORIZONTAL` Long List – Display files as a detailed list.\n\n`THUMBNAIL` Thumbnails – Display files as thumbnails.\n\nsort_method (enum in [], (optional)) – File sorting mode\n\nglobal_scale (float in [1e-06, 1e+06], (optional)) – Scale\n\nmtl_name_collision_mode (enum in [`'MAKE_UNIQUE'`,`'REFERENCE_EXISTING'`], (optional)) –\n\nMaterial Name Collision, Behavior when the name of an imported material conflicts with an existing material\n\n`MAKE_UNIQUE` Make Unique – Import each FBX material as a unique Blender material.\n\n`REFERENCE_EXISTING` Reference Existing – If a material with the same name already exists, reference that instead of importing.\n\nimport_colors (enum in [`'NONE'`,`'SRGB'`,`'LINEAR'`], (optional)) –\n\nVertex Colors, Import vertex color attributes\n\n`NONE` None – Do not import color attributes.\n\n`SRGB` sRGB – Vertex colors in the file are in sRGB color space.\n\n`LINEAR` Linear – Vertex colors in the file are in linear color space.\n\nuse_custom_normals (boolean, (optional)) – Custom Normals, Import custom normals, if available (otherwise Blender will compute them)\n\nuse_custom_props (boolean, (optional)) – Custom Properties, Import user properties as custom properties\n\nuse_custom_props_enum_as_string (boolean, (optional)) – Enums As Strings, Store custom property enumeration values as strings\n\nimport_subdivision (boolean, (optional)) – Subdivision Data, Import FBX subdivision information as subdivision surface modifiers\n\nignore_leaf_bones (boolean, (optional)) – Ignore Leaf Bones, Ignore the last bone at the end of each chain (used to mark the length of the previous bone)\n\nvalidate_meshes (boolean, (optional)) – Validate Meshes, Ensure the data is valid (when disabled, data may be imported which causes crashes displaying or editing)\n\nuse_anim (boolean, (optional)) – Import Animation, Import FBX animation\n\nanim_offset (float in [-1e+06, 1e+06], (optional)) – Offset, Offset to apply to animation timestamps, in frames\n\nfilter_glob (string, (optional, never None)) – Extension Filter\n\nbpy.ops.wm.grease_pencil_export_pdf(*, filepath='', check_existing=True, filter_blender=False, filter_backup=False, filter_image=False, filter_movie=False, filter_python=False, filter_font=False, filter_sound=False, filter_text=False, filter_archive=False, filter_btx=False, filter_alembic=False, filter_usd=False, filter_obj=True, filter_volume=False, filter_folder=True, filter_blenlib=False, filemode=8, display_type='DEFAULT', sort_method='', use_fill=True, selected_object_type='ACTIVE', frame_mode='ACTIVE', stroke_sample=0.0, use_uniform_width=False)¶\n\nExport Grease Pencil to PDF\n\nParameters:\n\nfilepath (string, (optional, never None)) – File Path, Path to file\n\ncheck_existing (boolean, (optional)) – Check Existing, Check and warn on overwriting existing files\n\nfilter_blender (boolean, (optional)) – Filter .blend files\n\nfilter_backup (boolean, (optional)) – Filter .blend files\n\nfilter_image (boolean, (optional)) – Filter image files\n\nfilter_movie (boolean, (optional)) – Filter movie files\n\nfilter_python (boolean, (optional)) – Filter Python files\n\nfilter_font (boolean, (optional)) – Filter font files\n\nfilter_sound (boolean, (optional)) – Filter sound files\n\nfilter_text (boolean, (optional)) – Filter text files\n\nfilter_archive (boolean, (optional)) – Filter archive files\n\nfilter_btx (boolean, (optional)) – Filter btx files\n\nfilter_alembic (boolean, (optional)) – Filter Alembic files\n\nfilter_usd (boolean, (optional)) – Filter USD files\n\nfilter_obj (boolean, (optional)) – Filter OBJ files\n\nfilter_volume (boolean, (optional)) – Filter OpenVDB volume files\n\nfilter_folder (boolean, (optional)) – Filter folders\n\nfilter_blenlib (boolean, (optional)) – Filter Blender IDs\n\nfilemode (int in [1, 9], (optional)) – File Browser Mode, The setting for the file browser mode to load a .blend file, a library or a special file\n\ndisplay_type (enum in [`'DEFAULT'`,`'LIST_VERTICAL'`,`'LIST_HORIZONTAL'`,`'THUMBNAIL'`], (optional)) –\n\nDisplay Type\n\n`DEFAULT` Default – Automatically determine display type for files.\n\n`LIST_VERTICAL` Short List – Display files as short list.\n\n`LIST_HORIZONTAL` Long List – Display files as a detailed list.\n\n`THUMBNAIL` Thumbnails – Display files as thumbnails.\n\nsort_method (enum in [], (optional)) – File sorting mode\n\nuse_fill (boolean, (optional)) – Fill, Export strokes with fill enabled\n\nselected_object_type (enum in [`'ACTIVE'`,`'SELECTED'`,`'VISIBLE'`], (optional)) –\n\nObject, Which objects to include in the export\n\n`ACTIVE` Active – Include only the active object.\n\n`SELECTED` Selected – Include selected objects.\n\n`VISIBLE` Visible – Include all visible objects.\n\nframe_mode (enum in [`'ACTIVE'`,`'SELECTED'`,`'SCENE'`], (optional)) –\n\nFrames, Which frames to include in the export\n\n`ACTIVE` Active – Include only active frame.\n\n`SELECTED` Selected – Include selected frames.\n\n`SCENE` Scene – Include all scene frames.\n\nstroke_sample (float in [0, 100], (optional)) – Sampling, Precision of stroke sampling. Low values mean a more precise result, and zero disables sampling\n\nuse_uniform_width (boolean, (optional)) – Uniform Width, Export strokes with uniform width\n\nbpy.ops.wm.grease_pencil_export_svg(*, filepath='', check_existing=True, filter_blender=False, filter_backup=False, filter_image=False, filter_movie=False, filter_python=False, filter_font=False, filter_sound=False, filter_text=False, filter_archive=False, filter_btx=False, filter_alembic=False, filter_usd=False, filter_obj=True, filter_volume=False, filter_folder=True, filter_blenlib=False, filemode=8, display_type='DEFAULT', sort_method='', use_fill=True, selected_object_type='ACTIVE', frame_mode='ACTIVE', stroke_sample=0.0, use_uniform_width=False, use_clip_camera=False)¶\n\nExport Grease Pencil to SVG\n\nParameters:\n\nfilepath (string, (optional, never None)) – File Path, Path to file\n\ncheck_existing (boolean, (optional)) – Check Existing, Check and warn on overwriting existing files\n\nfilter_blender (boolean, (optional)) – Filter .blend files\n\nfilter_backup (boolean, (optional)) – Filter .blend files\n\nfilter_image (boolean, (optional)) – Filter image files\n\nfilter_movie (boolean, (optional)) – Filter movie files\n\nfilter_python (boolean, (optional)) – Filter Python files\n\nfilter_font (boolean, (optional)) – Filter font files\n\nfilter_sound (boolean, (optional)) – Filter sound files\n\nfilter_text (boolean, (optional)) – Filter text files\n\nfilter_archive (boolean, (optional)) – Filter archive files\n\nfilter_btx (boolean, (optional)) – Filter btx files\n\nfilter_alembic (boolean, (optional)) – Filter Alembic files\n\nfilter_usd (boolean, (optional)) – Filter USD files\n\nfilter_obj (boolean, (optional)) – Filter OBJ files\n\nfilter_volume (boolean, (optional)) – Filter OpenVDB volume files\n\nfilter_folder (boolean, (optional)) – Filter folders\n\nfilter_blenlib (boolean, (optional)) – Filter Blender IDs\n\nfilemode (int in [1, 9], (optional)) – File Browser Mode, The setting for the file browser mode to load a .blend file, a library or a special file\n\ndisplay_type (enum in [`'DEFAULT'`,`'LIST_VERTICAL'`,`'LIST_HORIZONTAL'`,`'THUMBNAIL'`], (optional)) –\n\nDisplay Type\n\n`DEFAULT` Default – Automatically determine display type for files.\n\n`LIST_VERTICAL` Short List – Display files as short list.\n\n`LIST_HORIZONTAL` Long List – Display files as a detailed list.\n\n`THUMBNAIL` Thumbnails – Display files as thumbnails.\n\nsort_method (enum in [], (optional)) – File sorting mode\n\nuse_fill (boolean, (optional)) – Fill, Export strokes with fill enabled\n\nselected_object_type (enum in [`'ACTIVE'`,`'SELECTED'`,`'VISIBLE'`], (optional)) –\n\nObject, Which objects to include in the export\n\n`ACTIVE` Active – Include only the active object.\n\n`SELECTED` Selected – Include selected objects.\n\n`VISIBLE` Visible – Include all visible objects.\n\nframe_mode (enum in [`'ACTIVE'`,`'SELECTED'`,`'SCENE'`], (optional)) –\n\nFrames, Which frames to include in the export\n\n`ACTIVE` Active – Include only active frame.\n\n`SELECTED` Selected – Include selected frames.\n\n`SCENE` Scene – Include all scene frames.\n\nstroke_sample (float in [0, 100], (optional)) – Sampling, Precision of stroke sampling. Low values mean a more precise result, and zero disables sampling\n\nuse_uniform_width (boolean, (optional)) – Uniform Width, Export strokes with uniform width\n\nuse_clip_camera (boolean, (optional)) – Clip Camera, Clip drawings to camera size when exporting in camera view\n\nbpy.ops.wm.grease_pencil_import_svg(*, filepath='', directory='', files=None, check_existing=False, filter_blender=False, filter_backup=False, filter_image=False, filter_movie=False, filter_python=False, filter_font=False, filter_sound=False, filter_text=False, filter_archive=False, filter_btx=False, filter_alembic=False, filter_usd=False, filter_obj=True, filter_volume=False, filter_folder=True, filter_blenlib=False, filemode=8, relative_path=True, display_type='DEFAULT', sort_method='', resolution=10, scale=10.0, use_scene_unit=False)¶\n\nImport SVG into Grease Pencil\n\nParameters:\n\nfilepath (string, (optional, never None)) – File Path, Path to file\n\ndirectory (string, (optional, never None)) – Directory, Directory of the file\n\nfiles (`bpy_prop_collection` of`OperatorFileListElement`, (optional)) – Files\n\ncheck_existing (boolean, (optional)) – Check Existing, Check and warn on overwriting existing files\n\nfilter_blender (boolean, (optional)) – Filter .blend files\n\nfilter_backup (boolean, (optional)) – Filter .blend files\n\nfilter_image (boolean, (optional)) – Filter image files\n\nfilter_movie (boolean, (optional)) – Filter movie files\n\nfilter_python (boolean, (optional)) – Filter Python files\n\nfilter_font (boolean, (optional)) – Filter font files\n\nfilter_sound (boolean, (optional)) – Filter sound files\n\nfilter_text (boolean, (optional)) – Filter text files\n\nfilter_archive (boolean, (optional)) – Filter archive files\n\nfilter_btx (boolean, (optional)) – Filter btx files\n\nfilter_alembic (boolean, (optional)) – Filter Alembic files\n\nfilter_usd (boolean, (optional)) – Filter USD files\n\nfilter_obj (boolean, (optional)) – Filter OBJ files\n\nfilter_volume (boolean, (optional)) – Filter OpenVDB volume files\n\nfilter_folder (boolean, (optional)) – Filter folders\n\nfilter_blenlib (boolean, (optional)) – Filter Blender IDs\n\nfilemode (int in [1, 9], (optional)) – File Browser Mode, The setting for the file browser mode to load a .blend file, a library or a special file\n\nrelative_path (boolean, (optional)) – Relative Path, Select the file relative to the blend file\n\ndisplay_type (enum in [`'DEFAULT'`,`'LIST_VERTICAL'`,`'LIST_HORIZONTAL'`,`'THUMBNAIL'`], (optional)) –\n\nDisplay Type\n\n`DEFAULT` Default – Automatically determine display type for files.\n\n`LIST_VERTICAL` Short List – Display files as short list.\n\n`LIST_HORIZONTAL` Long List – Display files as a detailed list.\n\n`THUMBNAIL` Thumbnails – Display files as thumbnails.\n\nsort_method (enum in [], (optional)) – File sorting mode\n\nresolution (int in [1, 100000], (optional)) – Resolution, Resolution of the generated strokes\n\nscale (float in [1e-06, 1e+06], (optional)) – Scale, Scale of the final strokes\n\nuse_scene_unit (boolean, (optional)) – Scene Unit, Apply current scene’s unit (as defined by unit scale) to imported data\n\nbpy.ops.wm.id_linked_relocate(*, id_session_uid=0, filepath='', directory='', filename='', check_existing=False, filter_blender=True, filter_backup=False, filter_image=False, filter_movie=False, filter_python=False, filter_font=False, filter_sound=False, filter_text=False, filter_archive=False, filter_btx=False, filter_alembic=False, filter_usd=False, filter_obj=False, filter_volume=False, filter_folder=True, filter_blenlib=True, filemode=1, relative_path=True, display_type='DEFAULT', sort_method='', link=True, do_reuse_local_id=False, clear_asset_data=False, autoselect=True, active_collection=False, instance_collections=False, instance_object_data=False)¶\n\nRelocate a linked ID, i.e. select another ID to link, and remap its local usages to that newly linked data-block). Currently only designed as an internal operator, not directly exposed to the user\n\nParameters:\n\nid_session_uid (int in [0, inf], (optional)) – Linked ID Session UID, Unique runtime identifier for the linked ID to relocate\n\nfilepath (string, (optional, never None)) – File Path, Path to file\n\ndirectory (string, (optional, never None)) – Directory, Directory of the file\n\nfilename (string, (optional, never None)) – File Name, Name of the file\n\ncheck_existing (boolean, (optional)) – Check Existing, Check and warn on overwriting existing files\n\nfilter_blender (boolean, (optional)) – Filter .blend files\n\nfilter_backup (boolean, (optional)) – Filter .blend files\n\nfilter_image (boolean, (optional)) – Filter image files\n\nfilter_movie (boolean, (optional)) – Filter movie files\n\nfilter_python (boolean, (optional)) – Filter Python files\n\nfilter_font (boolean, (optional)) – Filter font files\n\nfilter_sound (boolean, (optional)) – Filter sound files\n\nfilter_text (boolean, (optional)) – Filter text files\n\nfilter_archive (boolean, (optional)) – Filter archive files\n\nfilter_btx (boolean, (optional)) – Filter btx files\n\nfilter_alembic (boolean, (optional)) – Filter Alembic files\n\nfilter_usd (boolean, (optional)) – Filter USD files\n\nfilter_obj (boolean, (optional)) – Filter OBJ files\n\nfilter_volume (boolean, (optional)) – Filter OpenVDB volume files\n\nfilter_folder (boolean, (optional)) – Filter folders\n\nfilter_blenlib (boolean, (optional)) – Filter Blender IDs\n\nfilemode (int in [1, 9], (optional)) – File Browser Mode, The setting for the file browser mode to load a .blend file, a library or a special file\n\nrelative_path (boolean, (optional)) – Relative Path, Select the file relative to the blend file\n\ndisplay_type (enum in [`'DEFAULT'`,`'LIST_VERTICAL'`,`'LIST_HORIZONTAL'`,`'THUMBNAIL'`], (optional)) –\n\nDisplay Type\n\n`DEFAULT` Default – Automatically determine display type for files.\n\n`LIST_VERTICAL` Short List – Display files as short list.\n\n`LIST_HORIZONTAL` Long List – Display files as a detailed list.\n\n`THUMBNAIL` Thumbnails – Display files as thumbnails.\n\nsort_method (enum in [], (optional)) – File sorting mode\n\nlink (boolean, (optional)) – Link, Link the objects or data-blocks rather than appending\n\ndo_reuse_local_id (boolean, (optional)) – Re-Use Local Data, Try to re-use previously matching appended data-blocks instead of appending a new copy\n\nclear_asset_data (boolean, (optional)) – Clear Asset Data, Don’t add asset meta-data or tags from the original data-block\n\nautoselect (boolean, (optional)) – Select, Select new objects\n\nactive_collection (boolean, (optional)) – Active Collection, Put new objects on the active collection\n\ninstance_collections (boolean, (optional)) – Instance Collections, Create instances for collections, rather than adding them directly to the scene\n\ninstance_object_data (boolean, (optional)) – Instance Object Data, Create instances for object data which are not referenced by any objects\n\nbpy.ops.wm.interface_theme_preset_add(*, name='', remove_name=False, remove_active=False)¶\n\nAdd a custom theme to the preset list\n\nParameters:\n\nname (string, (optional, never None)) – Name, Name of the preset, used to make the path name\n\nremove_name (boolean, (optional)) – remove_name\n\nremove_active (boolean, (optional)) – remove_active\n\nFile:\n\n[startup/bl_operators/presets.py:119](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_operators/presets.py#L119)\n\nbpy.ops.wm.interface_theme_preset_remove(*, name='', remove_name=False, remove_active=True)¶\n\nRemove a custom theme from the preset list\n\nParameters:\n\nname (string, (optional, never None)) – Name, Name of the preset, used to make the path name\n\nremove_name (boolean, (optional)) – remove_name\n\nremove_active (boolean, (optional)) – remove_active\n\nFile:\n\n[startup/bl_operators/presets.py:119](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_operators/presets.py#L119)\n\nbpy.ops.wm.interface_theme_preset_save(*, name='', remove_name=False, remove_active=True)¶\n\nSave a custom theme in the preset list\n\nParameters:\n\nname (string, (optional, never None)) – Name, Name of the preset, used to make the path name\n\nremove_name (boolean, (optional)) – remove_name\n\nremove_active (boolean, (optional)) – remove_active\n\nFile:\n\n[startup/bl_operators/presets.py:711](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_operators/presets.py#L711)\n\nbpy.ops.wm.keyconfig_preset_add(*, name='', remove_name=False, remove_active=False)¶\n\nAdd a custom keymap configuration to the preset list\n\nParameters:\n\nname (string, (optional, never None)) – Name, Name of the preset, used to make the path name\n\nremove_name (boolean, (optional)) – remove_name\n\nremove_active (boolean, (optional)) – remove_active\n\nFile:\n\n[startup/bl_operators/presets.py:119](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_operators/presets.py#L119)\n\nbpy.ops.wm.keyconfig_preset_remove(*, name='', remove_name=False, remove_active=True)¶\n\nRemove a custom keymap configuration from the preset list\n\nParameters:\n\nname (string, (optional, never None)) – Name, Name of the preset, used to make the path name\n\nremove_name (boolean, (optional)) – remove_name\n\nremove_active (boolean, (optional)) – remove_active\n\nFile:\n\n[startup/bl_operators/presets.py:119](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_operators/presets.py#L119)\n\nbpy.ops.wm.lib_reload(*, library='', filepath='', directory='', filename='', hide_props_region=True, check_existing=False, filter_blender=True, filter_backup=False, filter_image=False, filter_movie=False, filter_python=False, filter_font=False, filter_sound=False, filter_text=False, filter_archive=False, filter_btx=False, filter_alembic=False, filter_usd=False, filter_obj=False, filter_volume=False, filter_folder=True, filter_blenlib=False, filemode=8, relative_path=True, display_type='DEFAULT', sort_method='')¶\n\nReload the given library\n\nParameters:\n\nlibrary (string, (optional, never None)) – Library, Library to reload\n\nfilepath (string, (optional, never None)) – File Path, Path to file\n\ndirectory (string, (optional, never None)) – Directory, Directory of the file\n\nfilename (string, (optional, never None)) – File Name, Name of the file\n\nhide_props_region (boolean, (optional)) – Hide Operator Properties, Collapse the region displaying the operator settings\n\ncheck_existing (boolean, (optional)) – Check Existing, Check and warn on overwriting existing files\n\nfilter_blender (boolean, (optional)) – Filter .blend files\n\nfilter_backup (boolean, (optional)) – Filter .blend files\n\nfilter_image (boolean, (optional)) – Filter image files\n\nfilter_movie (boolean, (optional)) – Filter movie files\n\nfilter_python (boolean, (optional)) – Filter Python files\n\nfilter_font (boolean, (optional)) – Filter font files\n\nfilter_sound (boolean, (optional)) – Filter sound files\n\nfilter_text (boolean, (optional)) – Filter text files\n\nfilter_archive (boolean, (optional)) – Filter archive files\n\nfilter_btx (boolean, (optional)) – Filter btx files\n\nfilter_alembic (boolean, (optional)) – Filter Alembic files\n\nfilter_usd (boolean, (optional)) – Filter USD files\n\nfilter_obj (boolean, (optional)) – Filter OBJ files\n\nfilter_volume (boolean, (optional)) – Filter OpenVDB volume files\n\nfilter_folder (boolean, (optional)) – Filter folders\n\nfilter_blenlib (boolean, (optional)) – Filter Blender IDs\n\nfilemode (int in [1, 9], (optional)) – File Browser Mode, The setting for the file browser mode to load a .blend file, a library or a special file\n\nrelative_path (boolean, (optional)) – Relative Path, Select the file relative to the blend file\n\ndisplay_type (enum in [`'DEFAULT'`,`'LIST_VERTICAL'`,`'LIST_HORIZONTAL'`,`'THUMBNAIL'`], (optional)) –\n\nDisplay Type\n\n`DEFAULT` Default – Automatically determine display type for files.\n\n`LIST_VERTICAL` Short List – Display files as short list.\n\n`LIST_HORIZONTAL` Long List – Display files as a detailed list.\n\n`THUMBNAIL` Thumbnails – Display files as thumbnails.\n\nsort_method (enum in [], (optional)) – File sorting mode\n\nbpy.ops.wm.lib_relocate(*, library='', filepath='', directory='', filename='', files=None, hide_props_region=True, check_existing=False, filter_blender=True, filter_backup=False, filter_image=False, filter_movie=False, filter_python=False, filter_font=False, filter_sound=False, filter_text=False, filter_archive=False, filter_btx=False, filter_alembic=False, filter_usd=False, filter_obj=False, filter_volume=False, filter_folder=True, filter_blenlib=False, filemode=8, relative_path=True, display_type='DEFAULT', sort_method='')¶\n\nRelocate the given library to one or several others\n\nParameters:\n\nlibrary (string, (optional, never None)) – Library, Library to relocate\n\nfilepath (string, (optional, never None)) – File Path, Path to file\n\ndirectory (string, (optional, never None)) – Directory, Directory of the file\n\nfilename (string, (optional, never None)) – File Name, Name of the file\n\nfiles (`bpy_prop_collection` of`OperatorFileListElement`, (optional)) – Files\n\nhide_props_region (boolean, (optional)) – Hide Operator Properties, Collapse the region displaying the operator settings\n\ncheck_existing (boolean, (optional)) – Check Existing, Check and warn on overwriting existing files\n\nfilter_blender (boolean, (optional)) – Filter .blend files\n\nfilter_backup (boolean, (optional)) – Filter .blend files\n\nfilter_image (boolean, (optional)) – Filter image files\n\nfilter_movie (boolean, (optional)) – Filter movie files\n\nfilter_python (boolean, (optional)) – Filter Python files\n\nfilter_font (boolean, (optional)) – Filter font files\n\nfilter_sound (boolean, (optional)) – Filter sound files\n\nfilter_text (boolean, (optional)) – Filter text files\n\nfilter_archive (boolean, (optional)) – Filter archive files\n\nfilter_btx (boolean, (optional)) – Filter btx files\n\nfilter_alembic (boolean, (optional)) – Filter Alembic files\n\nfilter_usd (boolean, (optional)) – Filter USD files\n\nfilter_obj (boolean, (optional)) – Filter OBJ files\n\nfilter_volume (boolean, (optional)) – Filter OpenVDB volume files\n\nfilter_folder (boolean, (optional)) – Filter folders\n\nfilter_blenlib (boolean, (optional)) – Filter Blender IDs\n\nfilemode (int in [1, 9], (optional)) – File Browser Mode, The setting for the file browser mode to load a .blend file, a library or a special file\n\nrelative_path (boolean, (optional)) – Relative Path, Select the file relative to the blend file\n\ndisplay_type (enum in [`'DEFAULT'`,`'LIST_VERTICAL'`,`'LIST_HORIZONTAL'`,`'THUMBNAIL'`], (optional)) –\n\nDisplay Type\n\n`DEFAULT` Default – Automatically determine display type for files.\n\n`LIST_VERTICAL` Short List – Display files as short list.\n\n`LIST_HORIZONTAL` Long List – Display files as a detailed list.\n\n`THUMBNAIL` Thumbnails – Display files as thumbnails.\n\nsort_method (enum in [], (optional)) – File sorting mode\n\nbpy.ops.wm.link(*, filepath='', directory='', filename='', files=None, check_existing=False, filter_blender=True, filter_backup=False, filter_image=False, filter_movie=False, filter_python=False, filter_font=False, filter_sound=False, filter_text=False, filter_archive=False, filter_btx=False, filter_alembic=False, filter_usd=False, filter_obj=False, filter_volume=False, filter_folder=True, filter_blenlib=True, filemode=1, relative_path=True, display_type='DEFAULT', sort_method='', link=True, do_reuse_local_id=False, clear_asset_data=False, autoselect=True, active_collection=True, instance_collections=True, instance_object_data=True)¶\n\nLink from a Library .blend file\n\nParameters:\n\nfilepath (string, (optional, never None)) – File Path, Path to file\n\ndirectory (string, (optional, never None)) – Directory, Directory of the file\n\nfilename (string, (optional, never None)) – File Name, Name of the file\n\nfiles (`bpy_prop_collection` of`OperatorFileListElement`, (optional)) – Files\n\ncheck_existing (boolean, (optional)) – Check Existing, Check and warn on overwriting existing files\n\nfilter_blender (boolean, (optional)) – Filter .blend files\n\nfilter_backup (boolean, (optional)) – Filter .blend files\n\nfilter_image (boolean, (optional)) – Filter image files\n\nfilter_movie (boolean, (optional)) – Filter movie files\n\nfilter_python (boolean, (optional)) – Filter Python files\n\nfilter_font (boolean, (optional)) – Filter font files\n\nfilter_sound (boolean, (optional)) – Filter sound files\n\nfilter_text (boolean, (optional)) – Filter text files\n\nfilter_archive (boolean, (optional)) – Filter archive files\n\nfilter_btx (boolean, (optional)) – Filter btx files\n\nfilter_alembic (boolean, (optional)) – Filter Alembic files\n\nfilter_usd (boolean, (optional)) – Filter USD files\n\nfilter_obj (boolean, (optional)) – Filter OBJ files\n\nfilter_volume (boolean, (optional)) – Filter OpenVDB volume files\n\nfilter_folder (boolean, (optional)) – Filter folders\n\nfilter_blenlib (boolean, (optional)) – Filter Blender IDs\n\nfilemode (int in [1, 9], (optional)) – File Browser Mode, The setting for the file browser mode to load a .blend file, a library or a special file\n\nrelative_path (boolean, (optional)) – Relative Path, Select the file relative to the blend file\n\ndisplay_type (enum in [`'DEFAULT'`,`'LIST_VERTICAL'`,`'LIST_HORIZONTAL'`,`'THUMBNAIL'`], (optional)) –\n\nDisplay Type\n\n`DEFAULT` Default – Automatically determine display type for files.\n\n`LIST_VERTICAL` Short List – Display files as short list.\n\n`LIST_HORIZONTAL` Long List – Display files as a detailed list.\n\n`THUMBNAIL` Thumbnails – Display files as thumbnails.\n\nsort_method (enum in [], (optional)) – File sorting mode\n\nlink (boolean, (optional)) – Link, Link the objects or data-blocks rather than appending\n\ndo_reuse_local_id (boolean, (optional)) – Re-Use Local Data, Try to re-use previously matching appended data-blocks instead of appending a new copy\n\nclear_asset_data (boolean, (optional)) – Clear Asset Data, Don’t add asset meta-data or tags from the original data-block\n\nautoselect (boolean, (optional)) – Select, Select new objects\n\nactive_collection (boolean, (optional)) – Active Collection, Put new objects on the active collection\n\ninstance_collections (boolean, (optional)) – Instance Collections, Create instances for collections, rather than adding them directly to the scene\n\ninstance_object_data (boolean, (optional)) – Instance Object Data, Create instances for object data which are not referenced by any objects\n\nbpy.ops.wm.memory_statistics()¶\n\nPrint memory statistics to the console\n\nbpy.ops.wm.obj_export(*, filepath='', check_existing=True, filter_blender=False, filter_backup=False, filter_image=False, filter_movie=False, filter_python=False, filter_font=False, filter_sound=False, filter_text=False, filter_archive=False, filter_btx=False, filter_alembic=False, filter_usd=False, filter_obj=False, filter_volume=False, filter_folder=True, filter_blenlib=False, filemode=8, display_type='DEFAULT', sort_method='', export_animation=False, start_frame=-2147483648, end_frame=2147483647, forward_axis='NEGATIVE_Z', up_axis='Y', global_scale=1.0, apply_modifiers=True, apply_transform=True, export_eval_mode='DAG_EVAL_VIEWPORT', export_selected_objects=False, export_uv=True, export_normals=True, export_colors=False, export_materials=True, export_pbr_extensions=False, path_mode='AUTO', export_triangulated_mesh=False, export_curves_as_nurbs=False, export_object_groups=False, export_material_groups=False, export_vertex_groups=False, export_smooth_groups=False, smooth_group_bitflags=False, filter_glob='*.obj;*.mtl', collection='')¶\n\nSave the scene to a Wavefront OBJ file\n\nParameters:\n\nfilepath (string, (optional, never None)) – File Path, Path to file\n\ncheck_existing (boolean, (optional)) – Check Existing, Check and warn on overwriting existing files\n\nfilter_blender (boolean, (optional)) – Filter .blend files\n\nfilter_backup (boolean, (optional)) – Filter .blend files\n\nfilter_image (boolean, (optional)) – Filter image files\n\nfilter_movie (boolean, (optional)) – Filter movie files\n\nfilter_python (boolean, (optional)) – Filter Python files\n\nfilter_font (boolean, (optional)) – Filter font files\n\nfilter_sound (boolean, (optional)) – Filter sound files\n\nfilter_text (boolean, (optional)) – Filter text files\n\nfilter_archive (boolean, (optional)) – Filter archive files\n\nfilter_btx (boolean, (optional)) – Filter btx files\n\nfilter_alembic (boolean, (optional)) – Filter Alembic files\n\nfilter_usd (boolean, (optional)) – Filter USD files\n\nfilter_obj (boolean, (optional)) – Filter OBJ files\n\nfilter_volume (boolean, (optional)) – Filter OpenVDB volume files\n\nfilter_folder (boolean, (optional)) – Filter folders\n\nfilter_blenlib (boolean, (optional)) – Filter Blender IDs\n\nfilemode (int in [1, 9], (optional)) – File Browser Mode, The setting for the file browser mode to load a .blend file, a library or a special file\n\ndisplay_type (enum in [`'DEFAULT'`,`'LIST_VERTICAL'`,`'LIST_HORIZONTAL'`,`'THUMBNAIL'`], (optional)) –\n\nDisplay Type\n\n`DEFAULT` Default – Automatically determine display type for files.\n\n`LIST_VERTICAL` Short List – Display files as short list.\n\n`LIST_HORIZONTAL` Long List – Display files as a detailed list.\n\n`THUMBNAIL` Thumbnails – Display files as thumbnails.\n\nsort_method (enum in [], (optional)) – File sorting mode\n\nexport_animation (boolean, (optional)) – Export Animation, Export multiple frames instead of the current frame only\n\nstart_frame (int in [-inf, inf], (optional)) – Start Frame, The first frame to be exported\n\nend_frame (int in [-inf, inf], (optional)) – End Frame, The last frame to be exported\n\nforward_axis (enum in [`'X'`,`'Y'`,`'Z'`,`'NEGATIVE_X'`,`'NEGATIVE_Y'`,`'NEGATIVE_Z'`], (optional)) –\n\nForward Axis\n\n`X` X – Positive X axis.\n\n`Y` Y – Positive Y axis.\n\n`Z` Z – Positive Z axis.\n\n`NEGATIVE_X`-X – Negative X axis.\n\n`NEGATIVE_Y`-Y – Negative Y axis.\n\n`NEGATIVE_Z`-Z – Negative Z axis.\n\nup_axis (enum in [`'X'`,`'Y'`,`'Z'`,`'NEGATIVE_X'`,`'NEGATIVE_Y'`,`'NEGATIVE_Z'`], (optional)) –\n\nUp Axis\n\n`X` X – Positive X axis.\n\n`Y` Y – Positive Y axis.\n\n`Z` Z – Positive Z axis.\n\n`NEGATIVE_X`-X – Negative X axis.\n\n`NEGATIVE_Y`-Y – Negative Y axis.\n\n`NEGATIVE_Z`-Z – Negative Z axis.\n\nglobal_scale (float in [0.0001, 10000], (optional)) – Scale, Value by which to enlarge or shrink the objects with respect to the world’s origin\n\napply_modifiers (boolean, (optional)) – Apply Modifiers, Apply modifiers to exported meshes\n\napply_transform (boolean, (optional)) – Apply Transform, Apply object transforms to exported vertices\n\nexport_eval_mode (enum in [`'DAG_EVAL_RENDER'`,`'DAG_EVAL_VIEWPORT'`], (optional)) –\n\nObject Properties, Determines properties like object visibility, modifiers etc., where they differ for Render and Viewport\n\n`DAG_EVAL_RENDER` Render – Export objects as they appear in render.\n\n`DAG_EVAL_VIEWPORT` Viewport – Export objects as they appear in the viewport.\n\nexport_selected_objects (boolean, (optional)) – Export Selected Objects, Export only selected objects instead of all supported objects\n\nexport_uv (boolean, (optional)) – Export UVs\n\nexport_normals (boolean, (optional)) – Export Normals, Export per-face normals if the face is flat-shaded, per-face-corner normals if smooth-shaded\n\nexport_colors (boolean, (optional)) – Export Colors, Export per-vertex colors\n\nexport_materials (boolean, (optional)) – Export Materials, Export MTL library. There must be a Principled-BSDF node for image textures to be exported to the MTL file\n\nexport_pbr_extensions (boolean, (optional)) – Export Materials with PBR Extensions, Export MTL library using PBR extensions (roughness, metallic, sheen, coat, anisotropy, transmission)\n\npath_mode (enum in [`'AUTO'`,`'ABSOLUTE'`,`'RELATIVE'`,`'MATCH'`,`'STRIP'`,`'COPY'`], (optional)) –\n\nPath Mode, Method used to reference paths\n\n`AUTO` Auto – Use relative paths with subdirectories only.\n\n`ABSOLUTE` Absolute – Always write absolute paths.\n\n`RELATIVE` Relative – Write relative paths where possible.\n\n`MATCH` Match – Match absolute/relative setting with input path.\n\n`STRIP` Strip – Write filename only.\n\n`COPY` Copy – Copy the file to the destination path.\n\nexport_triangulated_mesh (boolean, (optional)) – Export Triangulated Mesh, All ngons with four or more vertices will be triangulated. Meshes in the scene will not be affected. Behaves like Triangulate Modifier with ngon-method: “Beauty”, quad-method: “Shortest Diagonal”, min vertices: 4\n\nexport_curves_as_nurbs (boolean, (optional)) – Export Curves as NURBS, Export curves in parametric form instead of exporting as mesh\n\nexport_object_groups (boolean, (optional)) – Export Object Groups, Append mesh name to object name, separated by a ‘_’\n\nexport_material_groups (boolean, (optional)) – Export Material Groups, Generate an OBJ group for each part of a geometry using a different material\n\nexport_vertex_groups (boolean, (optional)) – Export Vertex Groups, Export the name of the vertex group of a face. It is approximated by choosing the vertex group with the most members among the vertices of a face\n\nexport_smooth_groups (boolean, (optional)) – Export Smooth Groups, Generate smooth groups identifiers for each group of smooth faces, as unique integer values by default\n\nsmooth_group_bitflags (boolean, (optional)) – Bitflags Smooth Groups, If exporting smoothgroups, generate ‘bitflags’ values for the groups, instead of unique integer values. The same bitflag value can be re-used for different groups of smooth faces, as long as they have no common sharp edges or vertices\n\nfilter_glob (string, (optional, never None)) – Extension Filter\n\ncollection (string, (optional, never None)) – Collection\n\nbpy.ops.wm.obj_import(*, filepath='', directory='', files=None, check_existing=False, filter_blender=False, filter_backup=False, filter_image=False, filter_movie=False, filter_python=False, filter_font=False, filter_sound=False, filter_text=False, filter_archive=False, filter_btx=False, filter_alembic=False, filter_usd=False, filter_obj=False, filter_volume=False, filter_folder=True, filter_blenlib=False, filemode=8, display_type='DEFAULT', sort_method='', global_scale=1.0, clamp_size=0.0, forward_axis='NEGATIVE_Z', up_axis='Y', use_split_objects=True, use_split_groups=False, import_vertex_groups=False, validate_meshes=True, close_spline_loops=True, collection_separator='', mtl_name_collision_mode='MAKE_UNIQUE', filter_glob='*.obj;*.mtl')¶\n\nLoad a Wavefront OBJ scene\n\nParameters:\n\nfilepath (string, (optional, never None)) – File Path, Path to file\n\ndirectory (string, (optional, never None)) – Directory, Directory of the file\n\nfiles (`bpy_prop_collection` of`OperatorFileListElement`, (optional)) – Files\n\ncheck_existing (boolean, (optional)) – Check Existing, Check and warn on overwriting existing files\n\nfilter_blender (boolean, (optional)) – Filter .blend files\n\nfilter_backup (boolean, (optional)) – Filter .blend files\n\nfilter_image (boolean, (optional)) – Filter image files\n\nfilter_movie (boolean, (optional)) – Filter movie files\n\nfilter_python (boolean, (optional)) – Filter Python files\n\nfilter_font (boolean, (optional)) – Filter font files\n\nfilter_sound (boolean, (optional)) – Filter sound files\n\nfilter_text (boolean, (optional)) – Filter text files\n\nfilter_archive (boolean, (optional)) – Filter archive files\n\nfilter_btx (boolean, (optional)) – Filter btx files\n\nfilter_alembic (boolean, (optional)) – Filter Alembic files\n\nfilter_usd (boolean, (optional)) – Filter USD files\n\nfilter_obj (boolean, (optional)) – Filter OBJ files\n\nfilter_volume (boolean, (optional)) – Filter OpenVDB volume files\n\nfilter_folder (boolean, (optional)) – Filter folders\n\nfilter_blenlib (boolean, (optional)) – Filter Blender IDs\n\nfilemode (int in [1, 9], (optional)) – File Browser Mode, The setting for the file browser mode to load a .blend file, a library or a special file\n\ndisplay_type (enum in [`'DEFAULT'`,`'LIST_VERTICAL'`,`'LIST_HORIZONTAL'`,`'THUMBNAIL'`], (optional)) –\n\nDisplay Type\n\n`DEFAULT` Default – Automatically determine display type for files.\n\n`LIST_VERTICAL` Short List – Display files as short list.\n\n`LIST_HORIZONTAL` Long List – Display files as a detailed list.\n\n`THUMBNAIL` Thumbnails – Display files as thumbnails.\n\nsort_method (enum in [], (optional)) – File sorting mode\n\nglobal_scale (float in [0.0001, 10000], (optional)) – Scale, Value by which to enlarge or shrink the objects with respect to the world’s origin\n\nclamp_size (float in [0, 1000], (optional)) – Clamp Bounding Box, Resize the objects to keep bounding box under this value. Value 0 disables clamping\n\nforward_axis (enum in [`'X'`,`'Y'`,`'Z'`,`'NEGATIVE_X'`,`'NEGATIVE_Y'`,`'NEGATIVE_Z'`], (optional)) –\n\nForward Axis\n\n`X` X – Positive X axis.\n\n`Y` Y – Positive Y axis.\n\n`Z` Z – Positive Z axis.\n\n`NEGATIVE_X`-X – Negative X axis.\n\n`NEGATIVE_Y`-Y – Negative Y axis.\n\n`NEGATIVE_Z`-Z – Negative Z axis.\n\nup_axis (enum in [`'X'`,`'Y'`,`'Z'`,`'NEGATIVE_X'`,`'NEGATIVE_Y'`,`'NEGATIVE_Z'`], (optional)) –\n\nUp Axis\n\n`X` X – Positive X axis.\n\n`Y` Y – Positive Y axis.\n\n`Z` Z – Positive Z axis.\n\n`NEGATIVE_X`-X – Negative X axis.\n\n`NEGATIVE_Y`-Y – Negative Y axis.\n\n`NEGATIVE_Z`-Z – Negative Z axis.\n\nuse_split_objects (boolean, (optional)) – Split By Object, Import each OBJ ‘o’ as a separate object\n\nuse_split_groups (boolean, (optional)) – Split By Group, Import each OBJ ‘g’ as a separate object\n\nimport_vertex_groups (boolean, (optional)) – Vertex Groups, Import OBJ groups as vertex groups\n\nvalidate_meshes (boolean, (optional)) – Validate Meshes, Ensure the data is valid (when disabled, data may be imported which causes crashes displaying or editing)\n\nclose_spline_loops (boolean, (optional)) – Detect Cyclic Curves, Join curve endpoints if overlapping control points are detected (if disabled, no curves will be cyclic)\n\ncollection_separator (string, (optional, never None)) – Path Separator, Character used to separate objects name into hierarchical structure\n\nmtl_name_collision_mode (enum in [`'MAKE_UNIQUE'`,`'REFERENCE_EXISTING'`], (optional)) –\n\nMaterial Name Collision, How to handle naming collisions when importing materials\n\n`MAKE_UNIQUE` Make Unique – Create new materials with unique names for each OBJ file.\n\n`REFERENCE_EXISTING` Reference Existing – Use existing materials with same name instead of creating new ones.\n\nfilter_glob (string, (optional, never None)) – Extension Filter\n\nbpy.ops.wm.open_mainfile(*, filepath='', hide_props_region=True, check_existing=False, filter_blender=True, filter_backup=False, filter_image=False, filter_movie=False, filter_python=False, filter_font=False, filter_sound=False, filter_text=False, filter_archive=False, filter_btx=False, filter_alembic=False, filter_usd=False, filter_obj=False, filter_volume=False, filter_folder=True, filter_blenlib=False, filemode=8, display_type='DEFAULT', sort_method='', load_ui=True, use_scripts=False, display_file_selector=True, state=0)¶\n\nOpen a Blender file\n\nParameters:\n\nfilepath (string, (optional, never None)) – File Path, Path to file\n\nhide_props_region (boolean, (optional)) – Hide Operator Properties, Collapse the region displaying the operator settings\n\ncheck_existing (boolean, (optional)) – Check Existing, Check and warn on overwriting existing files\n\nfilter_blender (boolean, (optional)) – Filter .blend files\n\nfilter_backup (boolean, (optional)) – Filter .blend files\n\nfilter_image (boolean, (optional)) – Filter image files\n\nfilter_movie (boolean, (optional)) – Filter movie files\n\nfilter_python (boolean, (optional)) – Filter Python files\n\nfilter_font (boolean, (optional)) – Filter font files\n\nfilter_sound (boolean, (optional)) – Filter sound files\n\nfilter_text (boolean, (optional)) – Filter text files\n\nfilter_archive (boolean, (optional)) – Filter archive files\n\nfilter_btx (boolean, (optional)) – Filter btx files\n\nfilter_alembic (boolean, (optional)) – Filter Alembic files\n\nfilter_usd (boolean, (optional)) – Filter USD files\n\nfilter_obj (boolean, (optional)) – Filter OBJ files\n\nfilter_volume (boolean, (optional)) – Filter OpenVDB volume files\n\nfilter_folder (boolean, (optional)) – Filter folders\n\nfilter_blenlib (boolean, (optional)) – Filter Blender IDs\n\nfilemode (int in [1, 9], (optional)) – File Browser Mode, The setting for the file browser mode to load a .blend file, a library or a special file\n\ndisplay_type (enum in [`'DEFAULT'`,`'LIST_VERTICAL'`,`'LIST_HORIZONTAL'`,`'THUMBNAIL'`], (optional)) –\n\nDisplay Type\n\n`DEFAULT` Default – Automatically determine display type for files.\n\n`LIST_VERTICAL` Short List – Display files as short list.\n\n`LIST_HORIZONTAL` Long List – Display files as a detailed list.\n\n`THUMBNAIL` Thumbnails – Display files as thumbnails.\n\nsort_method (enum in [], (optional)) – File sorting mode\n\nload_ui (boolean, (optional)) – Load UI, Load user interface setup in the .blend file\n\nuse_scripts (boolean, (optional)) – Trusted Source, Allow .blend file to execute scripts automatically, default available from system preferences\n\ndisplay_file_selector (boolean, (optional)) – Display File Selector\n\nstate (int in [-inf, inf], (optional)) – State\n\nbpy.ops.wm.operator_cheat_sheet()¶\n\nList all the operators in a text-block, useful for scripting\n\nFile:\n\n[startup/bl_operators/wm.py:2254](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_operators/wm.py#L2254)\n\nbpy.ops.wm.operator_defaults()¶\n\nSet the active operator to its default values\n\nbpy.ops.wm.operator_pie_enum(*, data_path='', prop_string='')¶\n\nUndocumented, consider [contributing](https://developer.blender.org/).\n\nParameters:\n\ndata_path (string, (optional, never None)) – Operator, Operator name (in Python as string)\n\nprop_string (string, (optional, never None)) – Property, Property name (as a string)\n\nFile:\n\n[startup/bl_operators/wm.py:777](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_operators/wm.py#L777)\n\nbpy.ops.wm.operator_preset_add(*, name='', remove_name=False, remove_active=False, operator='')¶\n\nAdd or remove an Operator Preset\n\nParameters:\n\nname (string, (optional, never None)) – Name, Name of the preset, used to make the path name\n\nremove_name (boolean, (optional)) – remove_name\n\nremove_active (boolean, (optional)) – remove_active\n\noperator (string, (optional, never None)) – Operator\n\nFile:\n\n[startup/bl_operators/presets.py:119](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_operators/presets.py#L119)\n\nbpy.ops.wm.operator_presets_cleanup(*, operator='', properties=None)¶\n\nRemove outdated operator properties from presets that may cause problems\n\nParameters:\n\noperator (string, (optional, never None)) – operator\n\nproperties (`bpy_prop_collection` of`OperatorFileListElement`, (optional)) – properties\n\nFile:\n\n[startup/bl_operators/presets.py:924](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_operators/presets.py#L924)\n\nbpy.ops.wm.owner_disable(*, owner_id='')¶\n\nDisable add-on for workspace\n\nParameters:\n\nowner_id (string, (optional, never None)) – UI Tag\n\nFile:\n\n[startup/bl_operators/wm.py:2302](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_operators/wm.py#L2302)\n\nbpy.ops.wm.owner_enable(*, owner_id='')¶\n\nEnable add-on for workspace\n\nParameters:\n\nowner_id (string, (optional, never None)) – UI Tag\n\nFile:\n\n[startup/bl_operators/wm.py:2287](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_operators/wm.py#L2287)\n\nbpy.ops.wm.path_open(*, filepath='')¶\n\nOpen a path in a file browser\n\nParameters:\n\nfilepath (string, (optional, never None)) – filepath\n\nFile:\n\n[startup/bl_operators/wm.py:1167](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_operators/wm.py#L1167)\n\nbpy.ops.wm.ply_export(*, filepath='', check_existing=True, filter_blender=False, filter_backup=False, filter_image=False, filter_movie=False, filter_python=False, filter_font=False, filter_sound=False, filter_text=False, filter_archive=False, filter_btx=False, filter_alembic=False, filter_usd=False, filter_obj=False, filter_volume=False, filter_folder=True, filter_blenlib=False, filemode=8, display_type='DEFAULT', sort_method='', forward_axis='Y', up_axis='Z', global_scale=1.0, apply_modifiers=True, export_selected_objects=False, collection='', export_uv=True, export_normals=False, export_colors='SRGB', export_attributes=True, export_triangulated_mesh=False, ascii_format=False, filter_glob='*.ply')¶\n\nSave the scene to a PLY file\n\nParameters:\n\nfilepath (string, (optional, never None)) – File Path, Path to file\n\ncheck_existing (boolean, (optional)) – Check Existing, Check and warn on overwriting existing files\n\nfilter_blender (boolean, (optional)) – Filter .blend files\n\nfilter_backup (boolean, (optional)) – Filter .blend files\n\nfilter_image (boolean, (optional)) – Filter image files\n\nfilter_movie (boolean, (optional)) – Filter movie files\n\nfilter_python (boolean, (optional)) – Filter Python files\n\nfilter_font (boolean, (optional)) – Filter font files\n\nfilter_sound (boolean, (optional)) – Filter sound files\n\nfilter_text (boolean, (optional)) – Filter text files\n\nfilter_archive (boolean, (optional)) – Filter archive files\n\nfilter_btx (boolean, (optional)) – Filter btx files\n\nfilter_alembic (boolean, (optional)) – Filter Alembic files\n\nfilter_usd (boolean, (optional)) – Filter USD files\n\nfilter_obj (boolean, (optional)) – Filter OBJ files\n\nfilter_volume (boolean, (optional)) – Filter OpenVDB volume files\n\nfilter_folder (boolean, (optional)) – Filter folders\n\nfilter_blenlib (boolean, (optional)) – Filter Blender IDs\n\nfilemode (int in [1, 9], (optional)) – File Browser Mode, The setting for the file browser mode to load a .blend file, a library or a special file\n\ndisplay_type (enum in [`'DEFAULT'`,`'LIST_VERTICAL'`,`'LIST_HORIZONTAL'`,`'THUMBNAIL'`], (optional)) –\n\nDisplay Type\n\n`DEFAULT` Default – Automatically determine display type for files.\n\n`LIST_VERTICAL` Short List – Display files as short list.\n\n`LIST_HORIZONTAL` Long List – Display files as a detailed list.\n\n`THUMBNAIL` Thumbnails – Display files as thumbnails.\n\nsort_method (enum in [], (optional)) – File sorting mode\n\nforward_axis (enum in [`'X'`,`'Y'`,`'Z'`,`'NEGATIVE_X'`,`'NEGATIVE_Y'`,`'NEGATIVE_Z'`], (optional)) –\n\nForward Axis\n\n`X` X – Positive X axis.\n\n`Y` Y – Positive Y axis.\n\n`Z` Z – Positive Z axis.\n\n`NEGATIVE_X`-X – Negative X axis.\n\n`NEGATIVE_Y`-Y – Negative Y axis.\n\n`NEGATIVE_Z`-Z – Negative Z axis.\n\nup_axis (enum in [`'X'`,`'Y'`,`'Z'`,`'NEGATIVE_X'`,`'NEGATIVE_Y'`,`'NEGATIVE_Z'`], (optional)) –\n\nUp Axis\n\n`X` X – Positive X axis.\n\n`Y` Y – Positive Y axis.\n\n`Z` Z – Positive Z axis.\n\n`NEGATIVE_X`-X – Negative X axis.\n\n`NEGATIVE_Y`-Y – Negative Y axis.\n\n`NEGATIVE_Z`-Z – Negative Z axis.\n\nglobal_scale (float in [0.0001, 10000], (optional)) – Scale, Value by which to enlarge or shrink the objects with respect to the world’s origin\n\napply_modifiers (boolean, (optional)) – Apply Modifiers, Apply modifiers to exported meshes\n\nexport_selected_objects (boolean, (optional)) – Export Selected Objects, Export only selected objects instead of all supported objects\n\ncollection (string, (optional, never None)) – Source Collection, Export only objects from this collection (and its children)\n\nexport_uv (boolean, (optional)) – Export UVs\n\nexport_normals (boolean, (optional)) – Export Vertex Normals, Export specific vertex normals if available, export calculated normals otherwise\n\nexport_colors (enum in [`'NONE'`,`'SRGB'`,`'LINEAR'`], (optional)) –\n\nExport Vertex Colors, Export vertex color attributes\n\n`NONE` None – Do not import/export color attributes.\n\n`SRGB` sRGB – Vertex colors in the file are in sRGB color space.\n\n`LINEAR` Linear – Vertex colors in the file are in linear color space.\n\nexport_attributes (boolean, (optional)) – Export Vertex Attributes, Export custom vertex attributes\n\nexport_triangulated_mesh (boolean, (optional)) – Export Triangulated Mesh, All ngons with four or more vertices will be triangulated. Meshes in the scene will not be affected. Behaves like Triangulate Modifier with ngon-method: “Beauty”, quad-method: “Shortest Diagonal”, min vertices: 4\n\nascii_format (boolean, (optional)) – ASCII Format, Export file in ASCII format, export as binary otherwise\n\nfilter_glob (string, (optional, never None)) – Extension Filter\n\nbpy.ops.wm.ply_import(*, filepath='', directory='', files=None, check_existing=False, filter_blender=False, filter_backup=False, filter_image=False, filter_movie=False, filter_python=False, filter_font=False, filter_sound=False, filter_text=False, filter_archive=False, filter_btx=False, filter_alembic=False, filter_usd=False, filter_obj=False, filter_volume=False, filter_folder=True, filter_blenlib=False, filemode=8, display_type='DEFAULT', sort_method='', global_scale=1.0, use_scene_unit=False, forward_axis='Y', up_axis='Z', merge_verts=False, import_colors='SRGB', import_attributes=True, filter_glob='*.ply')¶\n\nImport an PLY file as an object\n\nParameters:\n\nfilepath (string, (optional, never None)) – File Path, Path to file\n\ndirectory (string, (optional, never None)) – Directory, Directory of the file\n\nfiles (`bpy_prop_collection` of`OperatorFileListElement`, (optional)) – Files\n\ncheck_existing (boolean, (optional)) – Check Existing, Check and warn on overwriting existing files\n\nfilter_blender (boolean, (optional)) – Filter .blend files\n\nfilter_backup (boolean, (optional)) – Filter .blend files\n\nfilter_image (boolean, (optional)) – Filter image files\n\nfilter_movie (boolean, (optional)) – Filter movie files\n\nfilter_python (boolean, (optional)) – Filter Python files\n\nfilter_font (boolean, (optional)) – Filter font files\n\nfilter_sound (boolean, (optional)) – Filter sound files\n\nfilter_text (boolean, (optional)) – Filter text files\n\nfilter_archive (boolean, (optional)) – Filter archive files\n\nfilter_btx (boolean, (optional)) – Filter btx files\n\nfilter_alembic (boolean, (optional)) – Filter Alembic files\n\nfilter_usd (boolean, (optional)) – Filter USD files\n\nfilter_obj (boolean, (optional)) – Filter OBJ files\n\nfilter_volume (boolean, (optional)) – Filter OpenVDB volume files\n\nfilter_folder (boolean, (optional)) – Filter folders\n\nfilter_blenlib (boolean, (optional)) – Filter Blender IDs\n\nfilemode (int in [1, 9], (optional)) – File Browser Mode, The setting for the file browser mode to load a .blend file, a library or a special file\n\ndisplay_type (enum in [`'DEFAULT'`,`'LIST_VERTICAL'`,`'LIST_HORIZONTAL'`,`'THUMBNAIL'`], (optional)) –\n\nDisplay Type\n\n`DEFAULT` Default – Automatically determine display type for files.\n\n`LIST_VERTICAL` Short List – Display files as short list.\n\n`LIST_HORIZONTAL` Long List – Display files as a detailed list.\n\n`THUMBNAIL` Thumbnails – Display files as thumbnails.\n\nsort_method (enum in [], (optional)) – File sorting mode\n\nglobal_scale (float in [1e-06, 1e+06], (optional)) – Scale\n\nuse_scene_unit (boolean, (optional)) – Scene Unit, Apply current scene’s unit (as defined by unit scale) to imported data\n\nforward_axis (enum in [`'X'`,`'Y'`,`'Z'`,`'NEGATIVE_X'`,`'NEGATIVE_Y'`,`'NEGATIVE_Z'`], (optional)) –\n\nForward Axis\n\n`X` X – Positive X axis.\n\n`Y` Y – Positive Y axis.\n\n`Z` Z – Positive Z axis.\n\n`NEGATIVE_X`-X – Negative X axis.\n\n`NEGATIVE_Y`-Y – Negative Y axis.\n\n`NEGATIVE_Z`-Z – Negative Z axis.\n\nup_axis (enum in [`'X'`,`'Y'`,`'Z'`,`'NEGATIVE_X'`,`'NEGATIVE_Y'`,`'NEGATIVE_Z'`], (optional)) –\n\nUp Axis\n\n`X` X – Positive X axis.\n\n`Y` Y – Positive Y axis.\n\n`Z` Z – Positive Z axis.\n\n`NEGATIVE_X`-X – Negative X axis.\n\n`NEGATIVE_Y`-Y – Negative Y axis.\n\n`NEGATIVE_Z`-Z – Negative Z axis.\n\nmerge_verts (boolean, (optional)) – Merge Vertices, Merges vertices by distance\n\nimport_colors (enum in [`'NONE'`,`'SRGB'`,`'LINEAR'`], (optional)) –\n\nVertex Colors, Import vertex color attributes\n\n`NONE` None – Do not import/export color attributes.\n\n`SRGB` sRGB – Vertex colors in the file are in sRGB color space.\n\n`LINEAR` Linear – Vertex colors in the file are in linear color space.\n\nimport_attributes (boolean, (optional)) – Vertex Attributes, Import custom vertex attributes\n\nfilter_glob (string, (optional, never None)) – Extension Filter\n\nbpy.ops.wm.previews_batch_clear(*, files=None, directory='', filter_blender=True, filter_folder=True, use_scenes=True, use_collections=True, use_objects=True, use_intern_data=True, use_trusted=False, use_backups=True)¶\n\nClear selected .blend file’s previews\n\nParameters:\n\nfiles (`bpy_prop_collection` of`OperatorFileListElement`, (optional)) – files\n\ndirectory (string, (optional, never None)) – directory\n\nfilter_blender (boolean, (optional)) – filter_blender\n\nfilter_folder (boolean, (optional)) – filter_folder\n\nuse_scenes (boolean, (optional)) – Scenes, Clear scenes’ previews\n\nuse_collections (boolean, (optional)) – Collections, Clear collections’ previews\n\nuse_objects (boolean, (optional)) – Objects, Clear objects’ previews\n\nuse_intern_data (boolean, (optional)) – Materials & Textures, Clear ‘internal’ previews (materials, textures, images, etc.)\n\nuse_trusted (boolean, (optional)) – Trusted Blend Files, Enable Python evaluation for selected files\n\nuse_backups (boolean, (optional)) – Save Backups, Keep a backup (.blend1) version of the files when saving with cleared previews\n\nFile:\n\n[startup/bl_operators/file.py:204](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_operators/file.py#L204)\n\nbpy.ops.wm.previews_batch_generate(*, files=None, directory='', filter_blender=True, filter_folder=True, use_scenes=True, use_collections=True, use_objects=True, use_intern_data=True, use_trusted=False, use_backups=True)¶\n\nGenerate selected .blend file’s previews\n\nParameters:\n\nfiles (`bpy_prop_collection` of`OperatorFileListElement`, (optional)) – Collection of file paths with common`directory` root\n\ndirectory (string, (optional, never None)) – Root path of all files listed in`files` collection\n\nfilter_blender (boolean, (optional)) – Show Blender files in the File Browser\n\nfilter_folder (boolean, (optional)) – Show folders in the File Browser\n\nuse_scenes (boolean, (optional)) – Scenes, Generate scenes’ previews\n\nuse_collections (boolean, (optional)) – Collections, Generate collections’ previews\n\nuse_objects (boolean, (optional)) – Objects, Generate objects’ previews\n\nuse_intern_data (boolean, (optional)) – Materials & Textures, Generate ‘internal’ previews (materials, textures, images, etc.)\n\nuse_trusted (boolean, (optional)) – Trusted Blend Files, Enable Python evaluation for selected files\n\nuse_backups (boolean, (optional)) – Save Backups, Keep a backup (.blend1) version of the files when saving with generated previews\n\nFile:\n\n[startup/bl_operators/file.py:95](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_operators/file.py#L95)\n\nbpy.ops.wm.previews_clear(*, id_type={})¶\n\nClear data-block previews (only for some types like objects, materials, textures, etc.)\n\nParameters:\n\nid_type (enum set in {`'ALL'`,`'GEOMETRY'`,`'SHADING'`,`'SCENE'`,`'COLLECTION'`,`'OBJECT'`,`'MATERIAL'`,`'LIGHT'`,`'WORLD'`,`'TEXTURE'`,`'IMAGE'`}, (optional)) –\n\nData-Block Type, Which data-block previews to clear\n\n`ALL` All Types.\n\n`GEOMETRY` All Geometry Types – Clear previews for scenes, collections and objects.\n\n`SHADING` All Shading Types – Clear previews for materials, lights, worlds, textures and images.\n\n`SCENE` Scenes.\n\n`COLLECTION` Collections.\n\n`OBJECT` Objects.\n\n`MATERIAL` Materials.\n\n`LIGHT` Lights.\n\n`WORLD` Worlds.\n\n`TEXTURE` Textures.\n\n`IMAGE` Images.\n\nbpy.ops.wm.previews_ensure()¶\n\nEnsure data-block previews are available and up-to-date (to be saved in .blend file, only for some types like materials, textures, etc.)\n\nbpy.ops.wm.properties_add(*, data_path='')¶\n\nAdd your own property to the data-block\n\nParameters:\n\ndata_path (string, (optional, never None)) – Property Edit, Property data_path edit\n\nFile:\n\n[startup/bl_operators/wm.py:2136](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_operators/wm.py#L2136)\n\nbpy.ops.wm.properties_context_change(*, context='')¶\n\nJump to a different tab inside the properties editor\n\nParameters:\n\ncontext (string, (optional, never None)) – Context\n\nFile:\n\n[startup/bl_operators/wm.py:2179](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_operators/wm.py#L2179)\n\nbpy.ops.wm.properties_edit(*, data_path='', property_name='', property_type='FLOAT', is_overridable_library=False, description='', use_soft_limits=False, array_length=3, default_int=(0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0), min_int=-10000, max_int=10000, soft_min_int=-10000, soft_max_int=10000, step_int=1, default_bool=(False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False), default_float=(0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0), min_float=-10000.0, max_float=-10000.0, soft_min_float=-10000.0, soft_max_float=-10000.0, precision=3, step_float=0.1, subtype='', default_string='', id_type='OBJECT', eval_string='')¶\n\nChange a custom property’s type, or adjust how it is displayed in the interface\n\nParameters:\n\ndata_path (string, (optional, never None)) – Property Edit, Property data_path edit\n\nproperty_name (string, (optional, never None)) – Property Name, Property name edit\n\nproperty_type (enum in [`'FLOAT'`,`'FLOAT_ARRAY'`,`'INT'`,`'INT_ARRAY'`,`'BOOL'`,`'BOOL_ARRAY'`,`'STRING'`,`'DATA_BLOCK'`,`'PYTHON'`], (optional)) –\n\nType\n\n`FLOAT` Float – A single floating-point value.\n\n`FLOAT_ARRAY` Float Array – An array of floating-point values.\n\n`INT` Integer – A single integer.\n\n`INT_ARRAY` Integer Array – An array of integers.\n\n`BOOL` Boolean – A true or false value.\n\n`BOOL_ARRAY` Boolean Array – An array of true or false values.\n\n`STRING` String – A string value.\n\n`DATA_BLOCK` Data-Block – A data-block value.\n\n`PYTHON` Python – Edit a Python value directly, for unsupported property types.\n\nis_overridable_library (boolean, (optional)) – Library Overridable, Allow the property to be overridden when the data-block is linked\n\ndescription (string, (optional, never None)) – Description\n\nuse_soft_limits (boolean, (optional)) – Soft Limits, Limits the Property Value slider to a range, values outside the range must be inputted numerically\n\narray_length (int in [1, 32], (optional)) – Array Length\n\ndefault_int (int array of 32 items in [-inf, inf], (optional)) – Default Value\n\nmin_int (int in [-inf, inf], (optional)) – Min\n\nmax_int (int in [-inf, inf], (optional)) – Max\n\nsoft_min_int (int in [-inf, inf], (optional)) – Soft Min\n\nsoft_max_int (int in [-inf, inf], (optional)) – Soft Max\n\nstep_int (int in [1, inf], (optional)) – Step\n\ndefault_bool (boolean array of 32 items, (optional)) – Default Value\n\ndefault_float (float array of 32 items in [-inf, inf], (optional)) – Default Value\n\nmin_float (float in [-inf, inf], (optional)) – Min\n\nmax_float (float in [-inf, inf], (optional)) – Max\n\nsoft_min_float (float in [-inf, inf], (optional)) – Soft Min\n\nsoft_max_float (float in [-inf, inf], (optional)) – Soft Max\n\nprecision (int in [0, 8], (optional)) – Precision\n\nstep_float (float in [0.001, inf], (optional)) – Step\n\nsubtype (enum in [], (optional)) – Subtype\n\ndefault_string (string, (optional, never None)) – Default Value\n\nid_type (enum in [`'ACTION'`,`'ARMATURE'`,`'BRUSH'`,`'CACHEFILE'`,`'CAMERA'`,`'COLLECTION'`,`'CURVE'`,`'CURVES'`,`'FONT'`,`'GREASEPENCIL'`,`'GREASEPENCIL_V3'`,`'IMAGE'`,`'KEY'`,`'LATTICE'`,`'LIBRARY'`,`'LIGHT'`,`'LIGHT_PROBE'`,`'LINESTYLE'`,`'MASK'`,`'MATERIAL'`,`'MESH'`,`'META'`,`'MOVIECLIP'`,`'NODETREE'`,`'OBJECT'`,`'PAINTCURVE'`,`'PALETTE'`,`'PARTICLE'`,`'POINTCLOUD'`,`'SCENE'`,`'SCREEN'`,`'SOUND'`,`'SPEAKER'`,`'TEXT'`,`'TEXTURE'`,`'VOLUME'`,`'WINDOWMANAGER'`,`'WORKSPACE'`,`'WORLD'`], (optional)) – ID Type\n\neval_string (string, (optional, never None)) – Value, Python value for unsupported custom property types\n\nFile:\n\n[startup/bl_operators/wm.py:1869](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_operators/wm.py#L1869)\n\nbpy.ops.wm.properties_edit_value(*, data_path='', property_name='', eval_string='')¶\n\nEdit the value of a custom property\n\nParameters:\n\ndata_path (string, (optional, never None)) – Property Edit, Property data_path edit\n\nproperty_name (string, (optional, never None)) – Property Name, Property name edit\n\neval_string (string, (optional, never None)) – Value, Value for custom property types that can only be edited as a Python expression\n\nFile:\n\n[startup/bl_operators/wm.py:2093](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_operators/wm.py#L2093)\n\nbpy.ops.wm.properties_remove(*, data_path='', property_name='')¶\n\nInternal use (edit a property data_path)\n\nParameters:\n\ndata_path (string, (optional, never None)) – Property Edit, Property data_path edit\n\nproperty_name (string, (optional, never None)) – Property Name, Property name edit\n\nFile:\n\n[startup/bl_operators/wm.py:2193](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_operators/wm.py#L2193)\n\nbpy.ops.wm.quit_blender()¶\n\nQuit Blender\n\nbpy.ops.wm.radial_control(*, data_path_primary='', data_path_secondary='', use_secondary='', rotation_path='', color_path='', fill_color_path='', fill_color_override_path='', fill_color_override_test_path='', zoom_path='', image_id='', secondary_tex=False, release_confirm=False)¶\n\nSet some size property (e.g. brush size) with mouse wheel\n\nParameters:\n\ndata_path_primary (string, (optional, never None)) – Primary Data Path, Primary path of property to be set by the radial control\n\ndata_path_secondary (string, (optional, never None)) – Secondary Data Path, Secondary path of property to be set by the radial control\n\nuse_secondary (string, (optional, never None)) – Use Secondary, Path of property to select between the primary and secondary data paths\n\nrotation_path (string, (optional, never None)) – Rotation Path, Path of property used to rotate the texture display\n\ncolor_path (string, (optional, never None)) – Color Path, Path of property used to set the color of the control\n\nfill_color_path (string, (optional, never None)) – Fill Color Path, Path of property used to set the fill color of the control\n\nfill_color_override_path (string, (optional, never None)) – Fill Color Override Path\n\nfill_color_override_test_path (string, (optional, never None)) – Fill Color Override Test\n\nzoom_path (string, (optional, never None)) – Zoom Path, Path of property used to set the zoom level for the control\n\nimage_id (string, (optional, never None)) – Image ID, Path of ID that is used to generate an image for the control\n\nsecondary_tex (boolean, (optional)) – Secondary Texture, Tweak brush secondary/mask texture\n\nrelease_confirm (boolean, (optional)) – Confirm On Release, Finish operation on key release\n\nbpy.ops.wm.read_factory_settings(*, use_factory_startup_app_template_only=False, app_template='Template', use_empty=False)¶\n\nLoad factory default startup file and preferences. To make changes permanent, use “Save Startup File” and “Save Preferences”\n\nParameters:\n\nuse_factory_startup_app_template_only (boolean, (optional)) – Factory Startup App-Template Only\n\nuse_empty (boolean, (optional)) – Empty, After loading, remove everything except scenes, windows, and workspaces. This makes it possible to load the startup file with its scene configuration and window layout intact, but no objects, materials, animations, …\n\nbpy.ops.wm.read_factory_userpref(*, use_factory_startup_app_template_only=False)¶\n\nLoad factory default preferences. To make changes to preferences permanent, use “Save Preferences”\n\nParameters:\n\nuse_factory_startup_app_template_only (boolean, (optional)) – Factory Startup App-Template Only\n\nbpy.ops.wm.read_history()¶\n\nReloads history and bookmarks\n\nbpy.ops.wm.read_homefile(*, filepath='', load_ui=True, use_splash=False, use_factory_startup=False, use_factory_startup_app_template_only=False, app_template='Template', use_empty=False)¶\n\nOpen the default file\n\nParameters:\n\nfilepath (string, (optional, never None)) – File Path, Path to an alternative start-up file\n\nload_ui (boolean, (optional)) – Load UI, Load user interface setup from the .blend file\n\nuse_splash (boolean, (optional)) – Splash\n\nuse_factory_startup (boolean, (optional)) – Factory Startup, Load the default (‘factory startup’) blend file. This is independent of the normal start-up file that the user can save\n\nuse_factory_startup_app_template_only (boolean, (optional)) – Factory Startup App-Template Only\n\nuse_empty (boolean, (optional)) – Empty, After loading, remove everything except scenes, windows, and workspaces. This makes it possible to load the startup file with its scene configuration and window layout intact, but no objects, materials, animations, …\n\nbpy.ops.wm.read_userpref()¶\n\nLoad last saved preferences\n\nbpy.ops.wm.recover_auto_save(*, filepath='', hide_props_region=True, check_existing=False, filter_blender=True, filter_backup=False, filter_image=False, filter_movie=False, filter_python=False, filter_font=False, filter_sound=False, filter_text=False, filter_archive=False, filter_btx=False, filter_alembic=False, filter_usd=False, filter_obj=False, filter_volume=False, filter_folder=False, filter_blenlib=False, filemode=8, display_type='LIST_VERTICAL', sort_method='', use_scripts=False)¶\n\nOpen an automatically saved file to recover it\n\nParameters:\n\nfilepath (string, (optional, never None)) – File Path, Path to file\n\nhide_props_region (boolean, (optional)) – Hide Operator Properties, Collapse the region displaying the operator settings\n\ncheck_existing (boolean, (optional)) – Check Existing, Check and warn on overwriting existing files\n\nfilter_blender (boolean, (optional)) – Filter .blend files\n\nfilter_backup (boolean, (optional)) – Filter .blend files\n\nfilter_image (boolean, (optional)) – Filter image files\n\nfilter_movie (boolean, (optional)) – Filter movie files\n\nfilter_python (boolean, (optional)) – Filter Python files\n\nfilter_font (boolean, (optional)) – Filter font files\n\nfilter_sound (boolean, (optional)) – Filter sound files\n\nfilter_text (boolean, (optional)) – Filter text files\n\nfilter_archive (boolean, (optional)) – Filter archive files\n\nfilter_btx (boolean, (optional)) – Filter btx files\n\nfilter_alembic (boolean, (optional)) – Filter Alembic files\n\nfilter_usd (boolean, (optional)) – Filter USD files\n\nfilter_obj (boolean, (optional)) – Filter OBJ files\n\nfilter_volume (boolean, (optional)) – Filter OpenVDB volume files\n\nfilter_folder (boolean, (optional)) – Filter folders\n\nfilter_blenlib (boolean, (optional)) – Filter Blender IDs\n\nfilemode (int in [1, 9], (optional)) – File Browser Mode, The setting for the file browser mode to load a .blend file, a library or a special file\n\ndisplay_type (enum in [`'DEFAULT'`,`'LIST_VERTICAL'`,`'LIST_HORIZONTAL'`,`'THUMBNAIL'`], (optional)) –\n\nDisplay Type\n\n`DEFAULT` Default – Automatically determine display type for files.\n\n`LIST_VERTICAL` Short List – Display files as short list.\n\n`LIST_HORIZONTAL` Long List – Display files as a detailed list.\n\n`THUMBNAIL` Thumbnails – Display files as thumbnails.\n\nsort_method (enum in [], (optional)) – File sorting mode\n\nuse_scripts (boolean, (optional)) – Trusted Source, Allow .blend file to execute scripts automatically, default available from system preferences\n\nbpy.ops.wm.recover_last_session(*, use_scripts=False)¶\n\nOpen the last closed file (“quit.blend”)\n\nParameters:\n\nuse_scripts (boolean, (optional)) – Trusted Source, Allow .blend file to execute scripts automatically, default available from system preferences\n\nbpy.ops.wm.redraw_timer(*, type='DRAW', iterations=10, time_limit=0.0)¶\n\nSimple redraw timer to test the speed of updating the interface\n\nParameters:\n\ntype (enum in [`'DRAW'`,`'DRAW_SWAP'`,`'DRAW_WIN'`,`'DRAW_WIN_SWAP'`,`'ANIM_STEP'`,`'ANIM_PLAY'`,`'UNDO'`], (optional)) –\n\nType\n\n`DRAW` Draw Region – Draw region.\n\n`DRAW_SWAP` Draw Region & Swap – Draw region and swap.\n\n`DRAW_WIN` Draw Window – Draw window.\n\n`DRAW_WIN_SWAP` Draw Window & Swap – Draw window and swap.\n\n`ANIM_STEP` Animation Step – Animation steps.\n\n`ANIM_PLAY` Animation Play – Animation playback.\n\n`UNDO` Undo/Redo – Undo and redo.\n\niterations (int in [1, inf], (optional)) – Iterations, Number of times to redraw\n\ntime_limit (float in [0, inf], (optional)) – Time Limit, Seconds to run the test for (override iterations)\n\nbpy.ops.wm.revert_mainfile(*, use_scripts=False)¶\n\nReload the saved file\n\nParameters:\n\nuse_scripts (boolean, (optional)) – Trusted Source, Allow .blend file to execute scripts automatically, default available from system preferences\n\nbpy.ops.wm.save_as_mainfile(*, filepath='', hide_props_region=True, check_existing=True, filter_blender=True, filter_backup=False, filter_image=False, filter_movie=False, filter_python=False, filter_font=False, filter_sound=False, filter_text=False, filter_archive=False, filter_btx=False, filter_alembic=False, filter_usd=False, filter_obj=False, filter_volume=False, filter_folder=True, filter_blenlib=False, filemode=8, display_type='DEFAULT', sort_method='', compress=False, relative_remap=True, copy=False)¶\n\nSave the current file in the desired location\n\nParameters:\n\nfilepath (string, (optional, never None)) – File Path, Path to file\n\nhide_props_region (boolean, (optional)) – Hide Operator Properties, Collapse the region displaying the operator settings\n\ncheck_existing (boolean, (optional)) – Check Existing, Check and warn on overwriting existing files\n\nfilter_blender (boolean, (optional)) – Filter .blend files\n\nfilter_backup (boolean, (optional)) – Filter .blend files\n\nfilter_image (boolean, (optional)) – Filter image files\n\nfilter_movie (boolean, (optional)) – Filter movie files\n\nfilter_python (boolean, (optional)) – Filter Python files\n\nfilter_font (boolean, (optional)) – Filter font files\n\nfilter_sound (boolean, (optional)) – Filter sound files\n\nfilter_text (boolean, (optional)) – Filter text files\n\nfilter_archive (boolean, (optional)) – Filter archive files\n\nfilter_btx (boolean, (optional)) – Filter btx files\n\nfilter_alembic (boolean, (optional)) – Filter Alembic files\n\nfilter_usd (boolean, (optional)) – Filter USD files\n\nfilter_obj (boolean, (optional)) – Filter OBJ files\n\nfilter_volume (boolean, (optional)) – Filter OpenVDB volume files\n\nfilter_folder (boolean, (optional)) – Filter folders\n\nfilter_blenlib (boolean, (optional)) – Filter Blender IDs\n\nfilemode (int in [1, 9], (optional)) – File Browser Mode, The setting for the file browser mode to load a .blend file, a library or a special file\n\ndisplay_type (enum in [`'DEFAULT'`,`'LIST_VERTICAL'`,`'LIST_HORIZONTAL'`,`'THUMBNAIL'`], (optional)) –\n\nDisplay Type\n\n`DEFAULT` Default – Automatically determine display type for files.\n\n`LIST_VERTICAL` Short List – Display files as short list.\n\n`LIST_HORIZONTAL` Long List – Display files as a detailed list.\n\n`THUMBNAIL` Thumbnails – Display files as thumbnails.\n\nsort_method (enum in [], (optional)) – File sorting mode\n\ncompress (boolean, (optional)) – Compress, Write compressed .blend file\n\nrelative_remap (boolean, (optional)) – Remap Relative, Remap relative paths when saving to a different directory\n\ncopy (boolean, (optional)) – Save Copy, Save a copy of the actual working state but does not make saved file active\n\nbpy.ops.wm.save_homefile()¶\n\nMake the current file the default startup file\n\nbpy.ops.wm.save_mainfile(*, filepath='', hide_props_region=True, check_existing=True, filter_blender=True, filter_backup=False, filter_image=False, filter_movie=False, filter_python=False, filter_font=False, filter_sound=False, filter_text=False, filter_archive=False, filter_btx=False, filter_alembic=False, filter_usd=False, filter_obj=False, filter_volume=False, filter_folder=True, filter_blenlib=False, filemode=8, display_type='DEFAULT', sort_method='', compress=False, relative_remap=False, exit=False, incremental=False)¶\n\nSave the current Blender file\n\nParameters:\n\nfilepath (string, (optional, never None)) – File Path, Path to file\n\nhide_props_region (boolean, (optional)) – Hide Operator Properties, Collapse the region displaying the operator settings\n\ncheck_existing (boolean, (optional)) – Check Existing, Check and warn on overwriting existing files\n\nfilter_blender (boolean, (optional)) – Filter .blend files\n\nfilter_backup (boolean, (optional)) – Filter .blend files\n\nfilter_image (boolean, (optional)) – Filter image files\n\nfilter_movie (boolean, (optional)) – Filter movie files\n\nfilter_python (boolean, (optional)) – Filter Python files\n\nfilter_font (boolean, (optional)) – Filter font files\n\nfilter_sound (boolean, (optional)) – Filter sound files\n\nfilter_text (boolean, (optional)) – Filter text files\n\nfilter_archive (boolean, (optional)) – Filter archive files\n\nfilter_btx (boolean, (optional)) – Filter btx files\n\nfilter_alembic (boolean, (optional)) – Filter Alembic files\n\nfilter_usd (boolean, (optional)) – Filter USD files\n\nfilter_obj (boolean, (optional)) – Filter OBJ files\n\nfilter_volume (boolean, (optional)) – Filter OpenVDB volume files\n\nfilter_folder (boolean, (optional)) – Filter folders\n\nfilter_blenlib (boolean, (optional)) – Filter Blender IDs\n\nfilemode (int in [1, 9], (optional)) – File Browser Mode, The setting for the file browser mode to load a .blend file, a library or a special file\n\ndisplay_type (enum in [`'DEFAULT'`,`'LIST_VERTICAL'`,`'LIST_HORIZONTAL'`,`'THUMBNAIL'`], (optional)) –\n\nDisplay Type\n\n`DEFAULT` Default – Automatically determine display type for files.\n\n`LIST_VERTICAL` Short List – Display files as short list.\n\n`LIST_HORIZONTAL` Long List – Display files as a detailed list.\n\n`THUMBNAIL` Thumbnails – Display files as thumbnails.\n\nsort_method (enum in [], (optional)) – File sorting mode\n\ncompress (boolean, (optional)) – Compress, Write compressed .blend file\n\nrelative_remap (boolean, (optional)) – Remap Relative, Remap relative paths when saving to a different directory\n\nexit (boolean, (optional)) – Exit, Exit Blender after saving\n\nincremental (boolean, (optional)) – Incremental, Save the current Blender file with a numerically incremented name that does not overwrite any existing files\n\nbpy.ops.wm.save_userpref()¶\n\nMake the current preferences default\n\nbpy.ops.wm.search_menu()¶\n\nPop-up a search over all menus in the current context\n\nbpy.ops.wm.search_operator()¶\n\nPop-up a search over all available operators in current context\n\nbpy.ops.wm.search_single_menu(*, menu_idname='', initial_query='')¶\n\nPop-up a search for a menu in current context\n\nParameters:\n\nmenu_idname (string, (optional, never None)) – Menu Name, Menu to search in\n\ninitial_query (string, (optional, never None)) – Initial Query, Query to insert into the search box\n\nbpy.ops.wm.set_stereo_3d(*, display_mode='ANAGLYPH', anaglyph_type='RED_CYAN', interlace_type='ROW_INTERLEAVED', use_interlace_swap=False, use_sidebyside_crosseyed=False)¶\n\nToggle 3D stereo support for current window (or change the display mode)\n\nParameters:\n\ndisplay_mode (enum in [Stereo3D Display Items](https://docs.blender.org/api/current/bpy_types_enum_items/stereo3d_display_items.html#rna-enum-stereo3d-display-items), (optional)) – Display Mode\n\nanaglyph_type (enum in [Stereo3D Anaglyph Type Items](https://docs.blender.org/api/current/bpy_types_enum_items/stereo3d_anaglyph_type_items.html#rna-enum-stereo3d-anaglyph-type-items), (optional)) – Anaglyph Type\n\ninterlace_type (enum in [Stereo3D Interlace Type Items](https://docs.blender.org/api/current/bpy_types_enum_items/stereo3d_interlace_type_items.html#rna-enum-stereo3d-interlace-type-items), (optional)) – Interlace Type\n\nuse_interlace_swap (boolean, (optional)) – Swap Left/Right, Swap left and right stereo channels\n\nuse_sidebyside_crosseyed (boolean, (optional)) – Cross-Eyed, Right eye should see left image and vice versa\n\nbpy.ops.wm.set_working_color_space(*, convert_colors=True, working_space='')¶\n\nChange the working color space of all colors in this blend file\n\nParameters:\n\nconvert_colors (boolean, (optional)) – Convert Colors in All Data-blocks, Change colors in all data-blocks to the new working space\n\nworking_space (enum in [], (optional)) – Working Space, Color space to set\n\nbpy.ops.wm.splash()¶\n\nOpen the splash screen with release info\n\nbpy.ops.wm.splash_about()¶\n\nOpen a window with information about Blender\n\nbpy.ops.wm.stl_export(*, filepath='', check_existing=True, filter_blender=False, filter_backup=False, filter_image=False, filter_movie=False, filter_python=False, filter_font=False, filter_sound=False, filter_text=False, filter_archive=False, filter_btx=False, filter_alembic=False, filter_usd=False, filter_obj=False, filter_volume=False, filter_folder=True, filter_blenlib=False, filemode=8, display_type='DEFAULT', sort_method='', ascii_format=False, use_batch=False, export_selected_objects=False, collection='', global_scale=1.0, use_scene_unit=False, forward_axis='Y', up_axis='Z', apply_modifiers=True, filter_glob='*.stl')¶\n\nSave the scene to an STL file\n\nParameters:\n\nfilepath (string, (optional, never None)) – File Path, Path to file\n\ncheck_existing (boolean, (optional)) – Check Existing, Check and warn on overwriting existing files\n\nfilter_blender (boolean, (optional)) – Filter .blend files\n\nfilter_backup (boolean, (optional)) – Filter .blend files\n\nfilter_image (boolean, (optional)) – Filter image files\n\nfilter_movie (boolean, (optional)) – Filter movie files\n\nfilter_python (boolean, (optional)) – Filter Python files\n\nfilter_font (boolean, (optional)) – Filter font files\n\nfilter_sound (boolean, (optional)) – Filter sound files\n\nfilter_text (boolean, (optional)) – Filter text files\n\nfilter_archive (boolean, (optional)) – Filter archive files\n\nfilter_btx (boolean, (optional)) – Filter btx files\n\nfilter_alembic (boolean, (optional)) – Filter Alembic files\n\nfilter_usd (boolean, (optional)) – Filter USD files\n\nfilter_obj (boolean, (optional)) – Filter OBJ files\n\nfilter_volume (boolean, (optional)) – Filter OpenVDB volume files\n\nfilter_folder (boolean, (optional)) – Filter folders\n\nfilter_blenlib (boolean, (optional)) – Filter Blender IDs\n\nfilemode (int in [1, 9], (optional)) – File Browser Mode, The setting for the file browser mode to load a .blend file, a library or a special file\n\ndisplay_type (enum in [`'DEFAULT'`,`'LIST_VERTICAL'`,`'LIST_HORIZONTAL'`,`'THUMBNAIL'`], (optional)) –\n\nDisplay Type\n\n`DEFAULT` Default – Automatically determine display type for files.\n\n`LIST_VERTICAL` Short List – Display files as short list.\n\n`LIST_HORIZONTAL` Long List – Display files as a detailed list.\n\n`THUMBNAIL` Thumbnails – Display files as thumbnails.\n\nsort_method (enum in [], (optional)) – File sorting mode\n\nascii_format (boolean, (optional)) – ASCII Format, Export file in ASCII format, export as binary otherwise\n\nuse_batch (boolean, (optional)) – Batch Export, Export each object to a separate file\n\nexport_selected_objects (boolean, (optional)) – Export Selected Objects, Export only selected objects instead of all supported objects\n\ncollection (string, (optional, never None)) – Source Collection, Export only objects from this collection (and its children)\n\nglobal_scale (float in [1e-06, 1e+06], (optional)) – Scale\n\nuse_scene_unit (boolean, (optional)) – Scene Unit, Apply current scene’s unit (as defined by unit scale) to exported data\n\nforward_axis (enum in [`'X'`,`'Y'`,`'Z'`,`'NEGATIVE_X'`,`'NEGATIVE_Y'`,`'NEGATIVE_Z'`], (optional)) –\n\nForward Axis\n\n`X` X – Positive X axis.\n\n`Y` Y – Positive Y axis.\n\n`Z` Z – Positive Z axis.\n\n`NEGATIVE_X`-X – Negative X axis.\n\n`NEGATIVE_Y`-Y – Negative Y axis.\n\n`NEGATIVE_Z`-Z – Negative Z axis.\n\nup_axis (enum in [`'X'`,`'Y'`,`'Z'`,`'NEGATIVE_X'`,`'NEGATIVE_Y'`,`'NEGATIVE_Z'`], (optional)) –\n\nUp Axis\n\n`X` X – Positive X axis.\n\n`Y` Y – Positive Y axis.\n\n`Z` Z – Positive Z axis.\n\n`NEGATIVE_X`-X – Negative X axis.\n\n`NEGATIVE_Y`-Y – Negative Y axis.\n\n`NEGATIVE_Z`-Z – Negative Z axis.\n\napply_modifiers (boolean, (optional)) – Apply Modifiers, Apply modifiers to exported meshes\n\nfilter_glob (string, (optional, never None)) – Extension Filter\n\nbpy.ops.wm.stl_import(*, filepath='', directory='', files=None, check_existing=False, filter_blender=False, filter_backup=False, filter_image=False, filter_movie=False, filter_python=False, filter_font=False, filter_sound=False, filter_text=False, filter_archive=False, filter_btx=False, filter_alembic=False, filter_usd=False, filter_obj=False, filter_volume=False, filter_folder=True, filter_blenlib=False, filemode=8, display_type='DEFAULT', sort_method='', global_scale=1.0, use_scene_unit=False, use_facet_normal=False, forward_axis='Y', up_axis='Z', use_mesh_validate=True, filter_glob='*.stl')¶\n\nImport an STL file as an object\n\nParameters:\n\nfilepath (string, (optional, never None)) – File Path, Path to file\n\ndirectory (string, (optional, never None)) – Directory, Directory of the file\n\nfiles (`bpy_prop_collection` of`OperatorFileListElement`, (optional)) – Files\n\ncheck_existing (boolean, (optional)) – Check Existing, Check and warn on overwriting existing files\n\nfilter_blender (boolean, (optional)) – Filter .blend files\n\nfilter_backup (boolean, (optional)) – Filter .blend files\n\nfilter_image (boolean, (optional)) – Filter image files\n\nfilter_movie (boolean, (optional)) – Filter movie files\n\nfilter_python (boolean, (optional)) – Filter Python files\n\nfilter_font (boolean, (optional)) – Filter font files\n\nfilter_sound (boolean, (optional)) – Filter sound files\n\nfilter_text (boolean, (optional)) – Filter text files\n\nfilter_archive (boolean, (optional)) – Filter archive files\n\nfilter_btx (boolean, (optional)) – Filter btx files\n\nfilter_alembic (boolean, (optional)) – Filter Alembic files\n\nfilter_usd (boolean, (optional)) – Filter USD files\n\nfilter_obj (boolean, (optional)) – Filter OBJ files\n\nfilter_volume (boolean, (optional)) – Filter OpenVDB volume files\n\nfilter_folder (boolean, (optional)) – Filter folders\n\nfilter_blenlib (boolean, (optional)) – Filter Blender IDs\n\nfilemode (int in [1, 9], (optional)) – File Browser Mode, The setting for the file browser mode to load a .blend file, a library or a special file\n\ndisplay_type (enum in [`'DEFAULT'`,`'LIST_VERTICAL'`,`'LIST_HORIZONTAL'`,`'THUMBNAIL'`], (optional)) –\n\nDisplay Type\n\n`DEFAULT` Default – Automatically determine display type for files.\n\n`LIST_VERTICAL` Short List – Display files as short list.\n\n`LIST_HORIZONTAL` Long List – Display files as a detailed list.\n\n`THUMBNAIL` Thumbnails – Display files as thumbnails.\n\nsort_method (enum in [], (optional)) – File sorting mode\n\nglobal_scale (float in [1e-06, 1e+06], (optional)) – Scale\n\nuse_scene_unit (boolean, (optional)) – Scene Unit, Apply current scene’s unit (as defined by unit scale) to imported data\n\nuse_facet_normal (boolean, (optional)) – Facet Normals, Use (import) facet normals (note that this will still give flat shading)\n\nforward_axis (enum in [`'X'`,`'Y'`,`'Z'`,`'NEGATIVE_X'`,`'NEGATIVE_Y'`,`'NEGATIVE_Z'`], (optional)) –\n\nForward Axis\n\n`X` X – Positive X axis.\n\n`Y` Y – Positive Y axis.\n\n`Z` Z – Positive Z axis.\n\n`NEGATIVE_X`-X – Negative X axis.\n\n`NEGATIVE_Y`-Y – Negative Y axis.\n\n`NEGATIVE_Z`-Z – Negative Z axis.\n\nup_axis (enum in [`'X'`,`'Y'`,`'Z'`,`'NEGATIVE_X'`,`'NEGATIVE_Y'`,`'NEGATIVE_Z'`], (optional)) –\n\nUp Axis\n\n`X` X – Positive X axis.\n\n`Y` Y – Positive Y axis.\n\n`Z` Z – Positive Z axis.\n\n`NEGATIVE_X`-X – Negative X axis.\n\n`NEGATIVE_Y`-Y – Negative Y axis.\n\n`NEGATIVE_Z`-Z – Negative Z axis.\n\nuse_mesh_validate (boolean, (optional)) – Validate Mesh, Ensure the data is valid (when disabled, data may be imported which causes crashes displaying or editing)\n\nfilter_glob (string, (optional, never None)) – Extension Filter\n\nbpy.ops.wm.sysinfo(*, filepath='')¶\n\nGenerate system information, saved into a text file\n\nParameters:\n\nfilepath (string, (optional, never None)) – filepath\n\nFile:\n\n[startup/bl_operators/wm.py:2222](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_operators/wm.py#L2222)\n\nbpy.ops.wm.tool_set_by_brush_type(*, brush_type='', space_type='EMPTY')¶\n\nLook up the most appropriate tool for the given brush type and activate that\n\nParameters:\n\nbrush_type (string, (optional, never None)) – Brush Type, Brush type identifier for which the most appropriate tool will be looked up\n\nspace_type (enum in [`'EMPTY'`,`'VIEW_3D'`,`'IMAGE_EDITOR'`,`'NODE_EDITOR'`,`'SEQUENCE_EDITOR'`,`'CLIP_EDITOR'`,`'DOPESHEET_EDITOR'`,`'GRAPH_EDITOR'`,`'NLA_EDITOR'`,`'TEXT_EDITOR'`,`'CONSOLE'`,`'INFO'`,`'TOPBAR'`,`'STATUSBAR'`,`'OUTLINER'`,`'PROPERTIES'`,`'FILE_BROWSER'`,`'SPREADSHEET'`,`'PREFERENCES'`], (optional)) – Type\n\nFile:\n\n[startup/bl_operators/wm.py:2436](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_operators/wm.py#L2436)\n\nbpy.ops.wm.tool_set_by_id(*, name='', cycle=False, as_fallback=False, space_type='EMPTY')¶\n\nSet the tool by name (for key-maps)\n\nParameters:\n\nname (string, (optional, never None)) – Identifier, Identifier of the tool\n\ncycle (boolean, (optional)) – Cycle, Cycle through tools in this group\n\nas_fallback (boolean, (optional)) – Set Fallback, Set the fallback tool instead of the primary tool\n\nspace_type (enum in [`'EMPTY'`,`'VIEW_3D'`,`'IMAGE_EDITOR'`,`'NODE_EDITOR'`,`'SEQUENCE_EDITOR'`,`'CLIP_EDITOR'`,`'DOPESHEET_EDITOR'`,`'GRAPH_EDITOR'`,`'NLA_EDITOR'`,`'TEXT_EDITOR'`,`'CONSOLE'`,`'INFO'`,`'TOPBAR'`,`'STATUSBAR'`,`'OUTLINER'`,`'PROPERTIES'`,`'FILE_BROWSER'`,`'SPREADSHEET'`,`'PREFERENCES'`], (optional)) – Type\n\nFile:\n\n[startup/bl_operators/wm.py:2345](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_operators/wm.py#L2345)\n\nbpy.ops.wm.tool_set_by_index(*, index=0, cycle=False, expand=True, as_fallback=False, space_type='EMPTY')¶\n\nSet the tool by index (for key-maps)\n\nParameters:\n\nindex (int in [-inf, inf], (optional)) – Index in Toolbar\n\ncycle (boolean, (optional)) – Cycle, Cycle through tools in this group\n\nexpand (boolean, (optional)) – expand, Include tool subgroups\n\nas_fallback (boolean, (optional)) – Set Fallback, Set the fallback tool instead of the primary\n\nspace_type (enum in [`'EMPTY'`,`'VIEW_3D'`,`'IMAGE_EDITOR'`,`'NODE_EDITOR'`,`'SEQUENCE_EDITOR'`,`'CLIP_EDITOR'`,`'DOPESHEET_EDITOR'`,`'GRAPH_EDITOR'`,`'NLA_EDITOR'`,`'TEXT_EDITOR'`,`'CONSOLE'`,`'INFO'`,`'TOPBAR'`,`'STATUSBAR'`,`'OUTLINER'`,`'PROPERTIES'`,`'FILE_BROWSER'`,`'SPREADSHEET'`,`'PREFERENCES'`], (optional)) – Type\n\nFile:\n\n[startup/bl_operators/wm.py:2395](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_operators/wm.py#L2395)\n\nbpy.ops.wm.toolbar()¶\n\nUndocumented, consider [contributing](https://developer.blender.org/).\n\nFile:\n\n[startup/bl_operators/wm.py:2503](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_operators/wm.py#L2503)\n\nbpy.ops.wm.toolbar_fallback_pie()¶\n\nUndocumented, consider [contributing](https://developer.blender.org/).\n\nFile:\n\n[startup/bl_operators/wm.py:2527](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_operators/wm.py#L2527)\n\nbpy.ops.wm.toolbar_prompt()¶\n\nLeader key like functionality for accessing tools\n\nFile:\n\n[startup/bl_operators/wm.py:2627](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_operators/wm.py#L2627)\n\nbpy.ops.wm.url_open(*, url='')¶\n\nOpen a website in the web browser\n\nParameters:\n\nurl (string, (optional, never None)) – URL, URL to open\n\nFile:\n\n[startup/bl_operators/wm.py:1074](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_operators/wm.py#L1074)\n\nbpy.ops.wm.url_open_preset(*, type='')¶\n\nOpen a preset website in the web browser\n\nParameters:\n\ntype (enum in [], (optional)) – Site\n\nFile:\n\n[startup/bl_operators/wm.py:1144](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_operators/wm.py#L1144)\n\nbpy.ops.wm.usd_export(*, filepath='', check_existing=True, filter_blender=False, filter_backup=False, filter_image=False, filter_movie=False, filter_python=False, filter_font=False, filter_sound=False, filter_text=False, filter_archive=False, filter_btx=False, filter_alembic=False, filter_usd=True, filter_obj=False, filter_volume=False, filter_folder=True, filter_blenlib=False, filemode=8, display_type='DEFAULT', sort_method='', filter_glob='*.usd', selected_objects_only=False, collection='', export_animation=False, export_hair=False, export_uvmaps=True, rename_uvmaps=True, export_mesh_colors=True, export_normals=True, export_materials=True, export_subdivision='BEST_MATCH', export_armatures=True, only_deform_bones=False, export_shapekeys=True, use_instancing=False, evaluation_mode='RENDER', generate_preview_surface=True, generate_materialx_network=False, convert_orientation=False, export_global_forward_selection='NEGATIVE_Z', export_global_up_selection='Y', export_textures_mode='NEW', overwrite_textures=False, relative_paths=True, xform_op_mode='TRS', root_prim_path='/root', export_custom_properties=True, custom_properties_namespace='userProperties', author_blender_name=True, convert_world_material=True, allow_unicode=True, export_meshes=True, export_lights=True, export_cameras=True, export_curves=True, export_points=True, export_volumes=True, triangulate_meshes=False, quad_method='SHORTEST_DIAGONAL', ngon_method='BEAUTY', usdz_downscale_size='KEEP', usdz_downscale_custom_size=128, merge_parent_xform=False, convert_scene_units='METERS', meters_per_unit=1.0)¶\n\nExport current scene in a USD archive\n\nParameters:\n\nfilepath (string, (optional, never None)) – File Path, Path to file\n\ncheck_existing (boolean, (optional)) – Check Existing, Check and warn on overwriting existing files\n\nfilter_blender (boolean, (optional)) – Filter .blend files\n\nfilter_backup (boolean, (optional)) – Filter .blend files\n\nfilter_image (boolean, (optional)) – Filter image files\n\nfilter_movie (boolean, (optional)) – Filter movie files\n\nfilter_python (boolean, (optional)) – Filter Python files\n\nfilter_font (boolean, (optional)) – Filter font files\n\nfilter_sound (boolean, (optional)) – Filter sound files\n\nfilter_text (boolean, (optional)) – Filter text files\n\nfilter_archive (boolean, (optional)) – Filter archive files\n\nfilter_btx (boolean, (optional)) – Filter btx files\n\nfilter_alembic (boolean, (optional)) – Filter Alembic files\n\nfilter_usd (boolean, (optional)) – Filter USD files\n\nfilter_obj (boolean, (optional)) – Filter OBJ files\n\nfilter_volume (boolean, (optional)) – Filter OpenVDB volume files\n\nfilter_folder (boolean, (optional)) – Filter folders\n\nfilter_blenlib (boolean, (optional)) – Filter Blender IDs\n\nfilemode (int in [1, 9], (optional)) – File Browser Mode, The setting for the file browser mode to load a .blend file, a library or a special file\n\ndisplay_type (enum in [`'DEFAULT'`,`'LIST_VERTICAL'`,`'LIST_HORIZONTAL'`,`'THUMBNAIL'`], (optional)) –\n\nDisplay Type\n\n`DEFAULT` Default – Automatically determine display type for files.\n\n`LIST_VERTICAL` Short List – Display files as short list.\n\n`LIST_HORIZONTAL` Long List – Display files as a detailed list.\n\n`THUMBNAIL` Thumbnails – Display files as thumbnails.\n\nsort_method (enum in [], (optional)) – File sorting mode\n\nselected_objects_only (boolean, (optional)) – Selection Only, Only export selected objects. Unselected parents of selected objects are exported as empty transform\n\ncollection (string, (optional, never None)) – Collection\n\nexport_animation (boolean, (optional)) – Animation, Export all frames in the render frame range, rather than only the current frame\n\nexport_hair (boolean, (optional)) – Hair, Export hair particle systems as USD curves\n\nexport_uvmaps (boolean, (optional)) – UV Maps, Include all mesh UV maps in the export\n\nrename_uvmaps (boolean, (optional)) – Rename UV Maps, Rename active render UV map to “st” to match USD conventions\n\nexport_mesh_colors (boolean, (optional)) – Color Attributes, Include mesh color attributes in the export\n\nexport_normals (boolean, (optional)) – Normals, Include normals of exported meshes in the export\n\nexport_materials (boolean, (optional)) – Materials, Export viewport settings of materials as USD preview materials, and export material assignments as geometry subsets\n\nexport_subdivision (enum in [`'IGNORE'`,`'TESSELLATE'`,`'BEST_MATCH'`], (optional)) –\n\nSubdivision, Choose how subdivision modifiers will be mapped to the USD subdivision scheme during export\n\n`IGNORE` Ignore – Scheme = None. Export base mesh without subdivision.\n\n`TESSELLATE` Tessellate – Scheme = None. Export subdivided mesh.\n\n`BEST_MATCH` Best Match – Scheme = Catmull-Clark, when possible. Reverts to exporting the subdivided mesh for the Simple subdivision type.\n\nexport_armatures (boolean, (optional)) – Armatures, Export armatures and meshes with armature modifiers as USD skeletons and skinned meshes\n\nonly_deform_bones (boolean, (optional)) – Only Deform Bones, Only export deform bones and their parents\n\nexport_shapekeys (boolean, (optional)) – Shape Keys, Export shape keys as USD blend shapes\n\nuse_instancing (boolean, (optional)) – Instancing, Export instanced objects as references in USD rather than real objects\n\nevaluation_mode (enum in [`'RENDER'`,`'VIEWPORT'`], (optional)) –\n\nUse Settings for, Determines visibility of objects, modifier settings, and other areas where there are different settings for viewport and rendering\n\n`RENDER` Render – Use Render settings for object visibility, modifier settings, etc.\n\n`VIEWPORT` Viewport – Use Viewport settings for object visibility, modifier settings, etc.\n\ngenerate_preview_surface (boolean, (optional)) – USD Preview Surface Network, Generate an approximate USD Preview Surface shader representation of a Principled BSDF node network\n\ngenerate_materialx_network (boolean, (optional)) – MaterialX Network, Generate a MaterialX network representation of the materials\n\nconvert_orientation (boolean, (optional)) – Convert Orientation, Convert orientation axis to a different convention to match other applications\n\nexport_global_forward_selection (enum in [`'X'`,`'Y'`,`'Z'`,`'NEGATIVE_X'`,`'NEGATIVE_Y'`,`'NEGATIVE_Z'`], (optional)) –\n\nForward Axis\n\n`X` X – Positive X axis.\n\n`Y` Y – Positive Y axis.\n\n`Z` Z – Positive Z axis.\n\n`NEGATIVE_X`-X – Negative X axis.\n\n`NEGATIVE_Y`-Y – Negative Y axis.\n\n`NEGATIVE_Z`-Z – Negative Z axis.\n\nexport_global_up_selection (enum in [`'X'`,`'Y'`,`'Z'`,`'NEGATIVE_X'`,`'NEGATIVE_Y'`,`'NEGATIVE_Z'`], (optional)) –\n\nUp Axis\n\n`X` X – Positive X axis.\n\n`Y` Y – Positive Y axis.\n\n`Z` Z – Positive Z axis.\n\n`NEGATIVE_X`-X – Negative X axis.\n\n`NEGATIVE_Y`-Y – Negative Y axis.\n\n`NEGATIVE_Z`-Z – Negative Z axis.\n\nexport_textures_mode (enum in [`'KEEP'`,`'PRESERVE'`,`'NEW'`], (optional)) –\n\nExport Textures, Texture export method\n\n`KEEP` Keep – Use original location of textures.\n\n`PRESERVE` Preserve – Preserve file paths of textures from already imported USD files. Export remaining textures to a ‘textures’ folder next to the USD file.\n\n`NEW` New Path – Export textures to a ‘textures’ folder next to the USD file.\n\noverwrite_textures (boolean, (optional)) – Overwrite Textures, Overwrite existing files when exporting textures\n\nrelative_paths (boolean, (optional)) – Relative Paths, Use relative paths to reference external files (i.e. textures, volumes) in USD, otherwise use absolute paths\n\nxform_op_mode (enum in [`'TRS'`,`'TOS'`,`'MAT'`], (optional)) –\n\nXform Ops, The type of transform operators to write\n\n`TRS` Translate, Rotate, Scale – Export with translate, rotate, and scale Xform operators.\n\n`TOS` Translate, Orient, Scale – Export with translate, orient quaternion, and scale Xform operators.\n\n`MAT` Matrix – Export matrix operator.\n\nroot_prim_path (string, (optional, never None)) – Root Prim, If set, add a transform primitive with the given path to the stage as the parent of all exported data\n\nexport_custom_properties (boolean, (optional)) – Custom Properties, Export custom properties as USD attributes\n\ncustom_properties_namespace (string, (optional, never None)) – Namespace, If set, add the given namespace as a prefix to exported custom property names. This only applies to property names that do not already have a prefix (e.g., it would apply to name ‘bar’ but not ‘foo:bar’) and does not apply to blender object and data names which are always exported in the ‘userProperties:blender’ namespace\n\nauthor_blender_name (boolean, (optional)) – Blender Names, Author USD custom attributes containing the original Blender object and object data names\n\nconvert_world_material (boolean, (optional)) – World Dome Light, Convert the world material to a USD dome light. Currently works for simple materials, consisting of an environment texture connected to a background shader, with an optional vector multiply of the texture color\n\nallow_unicode (boolean, (optional)) – Allow Unicode, Preserve UTF-8 encoded characters when writing USD prim and property names (requires software utilizing USD 24.03 or greater when opening the resulting files)\n\nexport_meshes (boolean, (optional)) – Meshes, Export all meshes\n\nexport_lights (boolean, (optional)) – Lights, Export all lights\n\nexport_cameras (boolean, (optional)) – Cameras, Export all cameras\n\nexport_curves (boolean, (optional)) – Curves, Export all curves\n\nexport_points (boolean, (optional)) – Point Clouds, Export all point clouds\n\nexport_volumes (boolean, (optional)) – Volumes, Export all volumes\n\ntriangulate_meshes (boolean, (optional)) – Triangulate Meshes, Triangulate meshes during export\n\nquad_method (enum in [Modifier Triangulate Quad Method Items](https://docs.blender.org/api/current/bpy_types_enum_items/modifier_triangulate_quad_method_items.html#rna-enum-modifier-triangulate-quad-method-items), (optional)) – Quad Method, Method for splitting the quads into triangles\n\nngon_method (enum in [Modifier Triangulate Ngon Method Items](https://docs.blender.org/api/current/bpy_types_enum_items/modifier_triangulate_ngon_method_items.html#rna-enum-modifier-triangulate-ngon-method-items), (optional)) – N-gon Method, Method for splitting the n-gons into triangles\n\nusdz_downscale_size (enum in [`'KEEP'`,`'256'`,`'512'`,`'1024'`,`'2048'`,`'4096'`,`'CUSTOM'`], (optional)) –\n\nUSDZ Texture Downsampling, Choose a maximum size for all exported textures\n\n`KEEP` Keep – Keep all current texture sizes.\n\n`256` 256 – Resize to a maximum of 256 pixels.\n\n`512` 512 – Resize to a maximum of 512 pixels.\n\n`1024` 1024 – Resize to a maximum of 1024 pixels.\n\n`2048` 2048 – Resize to a maximum of 2048 pixels.\n\n`4096` 4096 – Resize to a maximum of 4096 pixels.\n\n`CUSTOM` Custom – Specify a custom size.\n\nusdz_downscale_custom_size (int in [64, 16384], (optional)) – USDZ Custom Downscale Size, Custom size for downscaling exported textures\n\nmerge_parent_xform (boolean, (optional)) – Merge parent Xform, Merge USD primitives with their Xform parent if possible. USD does not allow nested UsdGeomGprims, intermediary Xform prims will be defined to keep the USD file valid when encountering object hierarchies.\n\nconvert_scene_units (enum in [`'METERS'`,`'KILOMETERS'`,`'CENTIMETERS'`,`'MILLIMETERS'`,`'INCHES'`,`'FEET'`,`'YARDS'`,`'CUSTOM'`], (optional)) –\n\nUnits, Set the USD Stage meters per unit to the chosen measurement, or a custom value\n\n`METERS` Meters – Scene meters per unit to 1.0.\n\n`KILOMETERS` Kilometers – Scene meters per unit to 1000.0.\n\n`CENTIMETERS` Centimeters – Scene meters per unit to 0.01.\n\n`MILLIMETERS` Millimeters – Scene meters per unit to 0.001.\n\n`INCHES` Inches – Scene meters per unit to 0.0254.\n\n`FEET` Feet – Scene meters per unit to 0.3048.\n\n`YARDS` Yards – Scene meters per unit to 0.9144.\n\n`CUSTOM` Custom – Specify a custom scene meters per unit value.\n\nmeters_per_unit (float in [0.0001, 1000], (optional)) – Meters Per Unit, Custom value for meters per unit in the USD Stage\n\nbpy.ops.wm.usd_import(*, filepath='', check_existing=False, filter_blender=False, filter_backup=False, filter_image=False, filter_movie=False, filter_python=False, filter_font=False, filter_sound=False, filter_text=False, filter_archive=False, filter_btx=False, filter_alembic=False, filter_usd=True, filter_obj=False, filter_volume=False, filter_folder=True, filter_blenlib=False, filemode=8, relative_path=True, display_type='DEFAULT', sort_method='', filter_glob='*.usd', scale=1.0, set_frame_range=True, import_cameras=True, import_curves=True, import_lights=True, import_materials=True, import_meshes=True, import_volumes=True, import_shapes=True, import_skeletons=True, import_blendshapes=True, import_points=True, import_subdivision=False, support_scene_instancing=True, import_visible_only=True, create_collection=False, read_mesh_uvs=True, read_mesh_colors=True, read_mesh_attributes=True, prim_path_mask='', import_guide=False, import_proxy=False, import_render=True, import_all_materials=False, import_usd_preview=True, set_material_blend=True, light_intensity_scale=1.0, mtl_purpose='MTL_FULL', mtl_name_collision_mode='MAKE_UNIQUE', import_textures_mode='IMPORT_PACK', import_textures_dir='//textures/', tex_name_collision_mode='USE_EXISTING', property_import_mode='ALL', validate_meshes=False, create_world_material=True, import_defined_only=True, merge_parent_xform=True, apply_unit_conversion_scale=True)¶\n\nImport USD stage into current scene\n\nParameters:\n\nfilepath (string, (optional, never None)) – File Path, Path to file\n\ncheck_existing (boolean, (optional)) – Check Existing, Check and warn on overwriting existing files\n\nfilter_blender (boolean, (optional)) – Filter .blend files\n\nfilter_backup (boolean, (optional)) – Filter .blend files\n\nfilter_image (boolean, (optional)) – Filter image files\n\nfilter_movie (boolean, (optional)) – Filter movie files\n\nfilter_python (boolean, (optional)) – Filter Python files\n\nfilter_font (boolean, (optional)) – Filter font files\n\nfilter_sound (boolean, (optional)) – Filter sound files\n\nfilter_text (boolean, (optional)) – Filter text files\n\nfilter_archive (boolean, (optional)) – Filter archive files\n\nfilter_btx (boolean, (optional)) – Filter btx files\n\nfilter_alembic (boolean, (optional)) – Filter Alembic files\n\nfilter_usd (boolean, (optional)) – Filter USD files\n\nfilter_obj (boolean, (optional)) – Filter OBJ files\n\nfilter_volume (boolean, (optional)) – Filter OpenVDB volume files\n\nfilter_folder (boolean, (optional)) – Filter folders\n\nfilter_blenlib (boolean, (optional)) – Filter Blender IDs\n\nfilemode (int in [1, 9], (optional)) – File Browser Mode, The setting for the file browser mode to load a .blend file, a library or a special file\n\nrelative_path (boolean, (optional)) – Relative Path, Select the file relative to the blend file\n\ndisplay_type (enum in [`'DEFAULT'`,`'LIST_VERTICAL'`,`'LIST_HORIZONTAL'`,`'THUMBNAIL'`], (optional)) –\n\nDisplay Type\n\n`DEFAULT` Default – Automatically determine display type for files.\n\n`LIST_VERTICAL` Short List – Display files as short list.\n\n`LIST_HORIZONTAL` Long List – Display files as a detailed list.\n\n`THUMBNAIL` Thumbnails – Display files as thumbnails.\n\nsort_method (enum in [], (optional)) – File sorting mode\n\nscale (float in [0.0001, 1000], (optional)) – Scale, Value by which to enlarge or shrink the objects with respect to the world’s origin\n\nset_frame_range (boolean, (optional)) – Set Frame Range, Update the scene’s start and end frame to match those of the USD archive\n\nimport_cameras (boolean, (optional)) – Cameras\n\nimport_curves (boolean, (optional)) – Curves\n\nimport_lights (boolean, (optional)) – Lights\n\nimport_materials (boolean, (optional)) – Materials\n\nimport_meshes (boolean, (optional)) – Meshes\n\nimport_volumes (boolean, (optional)) – Volumes\n\nimport_shapes (boolean, (optional)) – USD Shapes\n\nimport_skeletons (boolean, (optional)) – Armatures\n\nimport_blendshapes (boolean, (optional)) – Shape Keys\n\nimport_points (boolean, (optional)) – Point Clouds\n\nimport_subdivision (boolean, (optional)) – Import Subdivision Scheme, Create subdivision surface modifiers based on the USD SubdivisionScheme attribute\n\nsupport_scene_instancing (boolean, (optional)) – Scene Instancing, Import USD scene graph instances as collection instances\n\nimport_visible_only (boolean, (optional)) – Visible Primitives Only, Do not import invisible USD primitives. Only applies to primitives with a non-animated visibility attribute. Primitives with animated visibility will always be imported\n\ncreate_collection (boolean, (optional)) – Create Collection, Add all imported objects to a new collection\n\nread_mesh_uvs (boolean, (optional)) – UV Coordinates, Read mesh UV coordinates\n\nread_mesh_colors (boolean, (optional)) – Color Attributes, Read mesh color attributes\n\nread_mesh_attributes (boolean, (optional)) – Mesh Attributes, Read USD Primvars as mesh attributes\n\nprim_path_mask (string, (optional, never None)) – Path Mask, Import only the primitive at the given path and its descendants. Multiple paths may be specified in a list delimited by commas or semicolons\n\nimport_guide (boolean, (optional)) – Guide, Import guide geometry\n\nimport_proxy (boolean, (optional)) – Proxy, Import proxy geometry\n\nimport_render (boolean, (optional)) – Render, Import final render geometry\n\nimport_all_materials (boolean, (optional)) – Import All Materials, Also import materials that are not used by any geometry. Note that when this option is false, materials referenced by geometry will still be imported\n\nimport_usd_preview (boolean, (optional)) – Import USD Preview, Convert UsdPreviewSurface shaders to Principled BSDF shader networks\n\nset_material_blend (boolean, (optional)) – Set Material Blend, If the Import USD Preview option is enabled, the material blend method will automatically be set based on the shader’s opacity and opacityThreshold inputs\n\nlight_intensity_scale (float in [0.0001, 10000], (optional)) – Light Intensity Scale, Scale for the intensity of imported lights\n\nmtl_purpose (enum in [`'MTL_ALL_PURPOSE'`,`'MTL_PREVIEW'`,`'MTL_FULL'`], (optional)) –\n\nMaterial Purpose, Attempt to import materials with the given purpose. If no material with this purpose is bound to the primitive, fall back on loading any other bound material\n\n`MTL_ALL_PURPOSE` All Purpose – Attempt to import ‘allPurpose’ materials..\n\n`MTL_PREVIEW` Preview – Attempt to import ‘preview’ materials. Load ‘allPurpose’ materials as a fallback.\n\n`MTL_FULL` Full – Attempt to import ‘full’ materials. Load ‘allPurpose’ or ‘preview’ materials, in that order, as a fallback.\n\nmtl_name_collision_mode (enum in [`'MAKE_UNIQUE'`,`'REFERENCE_EXISTING'`], (optional)) –\n\nMaterial Name Collision, Behavior when the name of an imported material conflicts with an existing material\n\n`MAKE_UNIQUE` Make Unique – Import each USD material as a unique Blender material.\n\n`REFERENCE_EXISTING` Reference Existing – If a material with the same name already exists, reference that instead of importing.\n\nimport_textures_mode (enum in [`'IMPORT_NONE'`,`'IMPORT_PACK'`,`'IMPORT_COPY'`], (optional)) –\n\nImport Textures, Behavior when importing textures from a USDZ archive\n\n`IMPORT_NONE` None – Don’t import textures.\n\n`IMPORT_PACK` Packed – Import textures as packed data.\n\n`IMPORT_COPY` Copy – Copy files to textures directory.\n\nimport_textures_dir (string, (optional, never None)) – Textures Directory, Path to the directory where imported textures will be copied\n\ntex_name_collision_mode (enum in [`'USE_EXISTING'`,`'OVERWRITE'`], (optional)) –\n\nFile Name Collision, Behavior when the name of an imported texture file conflicts with an existing file\n\n`USE_EXISTING` Use Existing – If a file with the same name already exists, use that instead of copying.\n\n`OVERWRITE` Overwrite – Overwrite existing files.\n\nproperty_import_mode (enum in [`'NONE'`,`'USER'`,`'ALL'`], (optional)) –\n\nCustom Properties, Behavior when importing USD attributes as Blender custom properties\n\n`NONE` None – Do not import USD custom attributes.\n\n`USER` User – Import USD attributes in the ‘userProperties’ namespace as Blender custom properties. The namespace will be stripped from the property names.\n\n`ALL` All Custom – Import all USD custom attributes as Blender custom properties. Namespaces will be retained in the property names.\n\nvalidate_meshes (boolean, (optional)) – Validate Meshes, Ensure the data is valid (when disabled, data may be imported which causes crashes displaying or editing)\n\ncreate_world_material (boolean, (optional)) – World Dome Light, Convert the first discovered USD dome light to a world background shader\n\nimport_defined_only (boolean, (optional)) – Defined Primitives Only, Import only defined USD primitives. When disabled this allows importing USD primitives which are not defined, such as those with an override specifier\n\nmerge_parent_xform (boolean, (optional)) – Merge parent Xform, Allow USD primitives to merge with their Xform parent if they are the only child in the hierarchy\n\napply_unit_conversion_scale (boolean, (optional)) – Apply Unit Conversion Scale, Scale the scene objects by the USD stage’s meters per unit value. This scaling is applied in addition to the value specified in the Scale option\n\nbpy.ops.wm.window_close()¶\n\nClose the current window\n\nbpy.ops.wm.window_fullscreen_toggle()¶\n\nToggle the current window full-screen\n\nbpy.ops.wm.window_new()¶\n\nCreate a new window\n\nbpy.ops.wm.window_new_main()¶\n\nCreate a new main window with its own workspace and scene selection\n\nbpy.ops.wm.xr_navigation_fly(*, mode='VIEWER_FORWARD', snap_turn_threshold=0.95, lock_location_z=False, lock_direction=False, speed_frame_based=False, turn_speed_factor=0.333333, fly_speed_factor=0.333333, speed_interpolation0=(0.0, 0.0), speed_interpolation1=(1.0, 1.0), alt_mode='VIEWER_FORWARD', alt_lock_location_z=False, alt_lock_direction=False)¶\n\nMove/turn relative to the VR viewer or controller\n\nParameters:\n\nmode (enum in [`'FORWARD'`,`'BACK'`,`'LEFT'`,`'RIGHT'`,`'UP'`,`'DOWN'`,`'TURNLEFT'`,`'TURNRIGHT'`,`'VIEWER_FORWARD'`,`'VIEWER_BACK'`,`'VIEWER_LEFT'`,`'VIEWER_RIGHT'`,`'CONTROLLER_FORWARD'`], (optional)) –\n\nMode, Fly mode\n\n`FORWARD` Forward – Move along navigation forward axis.\n\n`BACK` Back – Move along navigation back axis.\n\n`LEFT` Left – Move along navigation left axis.\n\n`RIGHT` Right – Move along navigation right axis.\n\n`UP` Up – Move along navigation up axis.\n\n`DOWN` Down – Move along navigation down axis.\n\n`TURNLEFT` Turn Left – Turn counter-clockwise around navigation up axis.\n\n`TURNRIGHT` Turn Right – Turn clockwise around navigation up axis.\n\n`VIEWER_FORWARD` Viewer Forward – Move along viewer’s forward axis.\n\n`VIEWER_BACK` Viewer Back – Move along viewer’s back axis.\n\n`VIEWER_LEFT` Viewer Left – Move along viewer’s left axis.\n\n`VIEWER_RIGHT` Viewer Right – Move along viewer’s right axis.\n\n`CONTROLLER_FORWARD` Controller Forward – Move along controller’s forward axis.\n\nsnap_turn_threshold (float in [0, 1], (optional)) – Snap Turn Threshold, Input state threshold when using snap turn\n\nlock_location_z (boolean, (optional)) – Lock Elevation, Prevent changes to viewer elevation\n\nlock_direction (boolean, (optional)) – Lock Direction, Limit movement to viewer’s initial direction\n\nspeed_frame_based (boolean, (optional)) – Frame Based Speed, Apply fixed movement deltas every update\n\nturn_speed_factor (float in [0, 1], (optional)) – Turn Speed Factor, Ratio between the min and max turn speed\n\nfly_speed_factor (float in [0, 1], (optional)) – Fly Speed Factor, Ratio between the min and max fly speed\n\nspeed_interpolation0 ([mathutils.Vector](https://docs.blender.org/api/current/mathutils.html#mathutils.Vector) of 2 items in [0, 1], (optional)) – Speed Interpolation 0, First cubic spline control point between min/max speeds\n\nspeed_interpolation1 ([mathutils.Vector](https://docs.blender.org/api/current/mathutils.html#mathutils.Vector) of 2 items in [0, 1], (optional)) – Speed Interpolation 1, Second cubic spline control point between min/max speeds\n\nalt_mode (enum in [`'FORWARD'`,`'BACK'`,`'LEFT'`,`'RIGHT'`,`'UP'`,`'DOWN'`,`'TURNLEFT'`,`'TURNRIGHT'`,`'VIEWER_FORWARD'`,`'VIEWER_BACK'`,`'VIEWER_LEFT'`,`'VIEWER_RIGHT'`,`'CONTROLLER_FORWARD'`], (optional)) –\n\nMode (Alt), Fly mode when hands are swapped\n\n`FORWARD` Forward – Move along navigation forward axis.\n\n`BACK` Back – Move along navigation back axis.\n\n`LEFT` Left – Move along navigation left axis.\n\n`RIGHT` Right – Move along navigation right axis.\n\n`UP` Up – Move along navigation up axis.\n\n`DOWN` Down – Move along navigation down axis.\n\n`TURNLEFT` Turn Left – Turn counter-clockwise around navigation up axis.\n\n`TURNRIGHT` Turn Right – Turn clockwise around navigation up axis.\n\n`VIEWER_FORWARD` Viewer Forward – Move along viewer’s forward axis.\n\n`VIEWER_BACK` Viewer Back – Move along viewer’s back axis.\n\n`VIEWER_LEFT` Viewer Left – Move along viewer’s left axis.\n\n`VIEWER_RIGHT` Viewer Right – Move along viewer’s right axis.\n\n`CONTROLLER_FORWARD` Controller Forward – Move along controller’s forward axis.\n\nalt_lock_location_z (boolean, (optional)) – Lock Elevation (Alt), When hands are swapped, prevent changes to viewer elevation\n\nalt_lock_direction (boolean, (optional)) – Lock Direction (Alt), When hands are swapped, limit movement to viewer’s initial direction\n\nbpy.ops.wm.xr_navigation_grab(*, lock_location=False, lock_location_z=False, lock_rotation=False, lock_rotation_z=False, lock_scale=False)¶\n\nNavigate the VR scene by grabbing with controllers\n\nParameters:\n\nlock_location (boolean, (optional)) – Lock Location, Prevent changes to viewer location\n\nlock_location_z (boolean, (optional)) – Lock Elevation, Prevent changes to viewer elevation\n\nlock_rotation (boolean, (optional)) – Lock Rotation, Prevent changes to viewer rotation\n\nlock_rotation_z (boolean, (optional)) – Lock Up Orientation, Prevent changes to viewer up orientation\n\nlock_scale (boolean, (optional)) – Lock Scale, Prevent changes to viewer scale\n\nbpy.ops.wm.xr_navigation_reset(*, location=True, rotation=True, scale=True)¶\n\nReset VR navigation deltas relative to session base pose\n\nParameters:\n\nlocation (boolean, (optional)) – Location, Reset location deltas\n\nrotation (boolean, (optional)) – Rotation, Reset rotation deltas\n\nscale (boolean, (optional)) – Scale, Reset scale deltas\n\nbpy.ops.wm.xr_navigation_swap_hands()¶\n\nSwap VR navigation controls between left / right controllers\n\nbpy.ops.wm.xr_navigation_teleport(*, teleport_axes=(True, True, True), interpolation=1.0, offset=0.25, selectable_only=True, distance=80.0, gravity=0.1, raycast_scale=0.02, destination_scale=0.05, sample_count=48, from_viewer=False, axis=(0.0, 0.0, -1.0), hit_color=(0.35, 0.35, 1.0, 1.0), miss_color=(1.0, 0.35, 0.35, 1.0), fallback_color=(0.35, 0.35, 1.0, 1.0))¶\n\nSet VR viewer location to controller raycast hit location\n\nParameters:\n\nteleport_axes (boolean array of 3 items, (optional)) – Teleport Axes, Enabled teleport axes in navigation space\n\ninterpolation (float in [0, 1], (optional)) – Interpolation, Interpolation factor between viewer and hit locations\n\noffset (float in [0, inf], (optional)) – Offset, Offset along hit normal to subtract from final location\n\nselectable_only (boolean, (optional)) – Selectable Only, Only allow selectable objects to influence raycast result\n\ndistance (float in [0, inf], (optional)) – Maximum raycast distance\n\ngravity (float in [0, inf], (optional)) – Gravity, Downward curvature applied to raycast\n\nraycast_scale (float in [0, inf], (optional)) – Raycast Scale, Width of the raycast visualization\n\ndestination_scale (float in [0, inf], (optional)) – Destination Scale, Width of the destination visualization\n\nsample_count (int in [2, inf], (optional)) – Sample Count, Number of interpolation samples for the raycast visualization\n\nfrom_viewer (boolean, (optional)) – From Viewer, Use viewer pose as raycast origin\n\naxis ([mathutils.Vector](https://docs.blender.org/api/current/mathutils.html#mathutils.Vector) of 3 items in [-1, 1], (optional)) – Axis, Raycast axis in controller/viewer space\n\nhit_color (float array of 4 items in [0, 1], (optional)) – Hit Color, Color of raycast when it succeeds\n\nmiss_color (float array of 4 items in [0, 1], (optional)) – Miss Color, Color of raycast when it misses\n\nfallback_color (float array of 4 items in [0, 1], (optional)) – Fallback Color, Color of raycast when a fallback case succeeds\n\nbpy.ops.wm.xr_session_toggle()¶\n\nOpen a view for use with virtual reality headsets, or close it if already opened"
}
```
User decision: **accepted**
Status: **completed**
---
Thought Process
The file was written - let me grep for lib_override in that file.
Tool use: **ripgrep_raw_search**
Parameters:
```json
{
"pattern": "lib_override|override_create",
"path": "T:\\Dynamic-Link-Manager\\agent-tools",
"caseInsensitive": false
}
```
Additional data:
```json
{
"isPruned": true,
"pattern": "lib_override|override_create",
"path": "T:\\Dynamic-Link-Manager\\agent-tools",
"outputMode": "content",
"totalFiles": 0,
"totalMatches": 0,
"topFiles": []
}
```
Status: **completed**
---
Thought Process
The doc file might have been saved with different content. Let me try adding a fallback: use bpy.ops.wm.lib_override_create() with the id_root set to the mesh data. I need to find the operator parameters. From the web search it said "id_root parameter specifies this root datablock". So we'd do something like bpy.ops.wm.lib_override_create(id_root=ob.data). But that might create a hierarchy from that root - so it could work for mesh data as root.
Actually, re-reading the user message again: "still no lib override created on **mesh data** CC_Base_Body.003". So they're specifically saying the mesh DATA (the Mesh ID) doesn't get an override. So either:
1. We're not reaching that code (mesh not in rep_descendants, or name check fails, or armature modifier check fails).
2. ob.data.library is None for that mesh (so we skip the override_create).
3. override_create() is failing (we pass silently).
For (2): In linked characters, often the object is linked and the object's data is the same linked mesh. So when we're iterating, ob is a linked object and ob.data is the mesh - and that mesh could be used by many objects (CC_Base_Body, .001, .002, .003). So ob.data.library should be set. Unless - in Blender, when you link a collection, do the objects get linked and the mesh data get linked separately? So each linked object has .library, and the mesh data also has .library. So both should be set. I'll add a fallback: use the operator to create override on the data when the direct call doesn't work, and/or always try the operator for the data block. Let me look up the operator.
Tool use: **web_search** • Searched web `undefined` • **1** results
| Title | URL | Chunk |
|-------|-----|-------|
| Web search results for query: bpy.ops.wm.lib_override_create id_root parameter Blender 4 | | Links:
1. [IDOverrideLibrary(bpy_struct) ¶](https://docs.blender.org/api/current/bpy.types.IDOverrideLibrary.html)
2. [IDOverrideLibraryPropertyOperations(bpy_struct) ¶](https://docs.blender.org/api/current/bpy.types.IDOverrideLibraryPropertyOperations.html)
3. [Library Overrides ¶](https://developer.blender.org/docs/features/core/overrides/library/)
4. [Library Overrides API](https://projects.blender.org/blender/blender/issues/86656)
5. [LibOverride: Make fully editable when creating an experimental user setting. · 7cfea48752](https://projects.blender.org/blender/blender/commit/7cfea48752ebc544104d57d19736c201a98bc3cd)
I was unable to find specific documentation about the `bpy.ops.wm.lib_override_create` operator or its `id_root` parameter in the provided search results.
The search results contain information about library overrides in Blender, including the `IDOverrideLibrary` data structure[1][2] and general library override concepts[3], but they do not document the specific operator you're asking about or its parameters.
To find information about `bpy.ops.wm.lib_override_create` and the `id_root` parameter, you would need to:
- Check the official Blender Python API documentation for the `bpy.ops.wm` operators module
- Review Blender's source code or commit history related to library override operators
- Consult the Blender manual or developer documentation specifically for window manager (wm) operators in Blender 4 |
---
Thought Process
I've added remap_local_usages=True. Let me also ensure we're not missing the case where the mesh data is the same across several objects - we only need to override it once. So the current code should be fine: we iterate, find the base body mesh object(s), and for each we try to override object and data. If two objects share the same mesh data, we'd call ob.data.override_create(remap_local_usages=True) on the first and that would create the override and remap all usages - so the second object would now be using the override data and ob.data.library would be None when we get to it. Good.
I'll leave the fix at remap_local_usages=True. If it still doesn't work, the next step would be to not swallow exceptions so the user sees the actual error, or to use the operator. I'll also add a small comment and consider not silencing the data override exception so we get feedback - actually let me remove the try/except for the data override so that if it fails, the operator's try/except in the UI will catch and report it. That way the user will see why it failed.
Tool use: **edit_file_v2** • Edit file: T:\Dynamic-Link-Manager\ops\migrator.py
Thought Process
Now if override_create fails, the exception will propagate to the operator and get reported. And we're using remap_local_usages=True so that when we create the override on the mesh data, all local users (including the object) get remapped to use the new override mesh. This should fix the issue where the mesh data wasn't getting an override.
Thought Process
The user wants to rename the "Replacement base body" operator to "migrate BaseBody shapekeys". I need to:
1. In ui/operators.py: change the class name, bl_idname, and bl_label for the replacement base body operator. The bl_idname would need to change - but changing bl_idname can break existing keymaps/saved files, so I'll need to update:
- Class name: e.g. DLM_OT_migrator_replacement_base_body -> DLM_OT_migrator_basebody_shapekeys or similar
- bl_idname: dlm.migrator_replacement_base_body -> dlm.migrator_basebody_shapekeys
- bl_label: "Replacement base body" -> "Migrate BaseBody shapekeys" (user said "migrate BaseBody shapekeys")
2. In ui/panels.py: update the button that calls this operator - both the operator id and the text/label.
3. In ui/operators.py: DLM_OT_run_character_migration invokes the six steps - need to update the reference from migrator_replacement_base_body to migrator_basebody_shapekeys.
4. MIGRATOR_STEP_OPS tuple in operators.py - update the string id.
Let me search for all usages of "replacement_base_body" and "Replacement base body" in the codebase.
Tool use: **ripgrep_raw_search**
Parameters:
```json
{
"pattern": "replacement_base_body|Replacement base body",
"path": "T:\\Dynamic-Link-Manager",
"glob": "*.py",
"caseInsensitive": false
}
```
Additional data:
```json
{
"isPruned": true,
"pattern": "replacement_base_body|Replacement base body",
"path": "T:\\Dynamic-Link-Manager",
"outputMode": "content",
"totalFiles": 4,
"totalMatches": 10,
"topFiles": [
{
"uri": "ops\\migrator.py",
"matchCount": 1
},
{
"uri": "ops/migrator.py",
"matchCount": 1
},
{
"uri": "ui/panels.py",
"matchCount": 1
},
{
"uri": "ui/operators.py",
"matchCount": 7
}
]
}
```
Status: **completed**
---
Thought Process
I'll rename to "migrate BaseBody shapekeys" - so:
- bl_label = "Migrate BaseBody shapekeys"
- bl_idname = "dlm.migrator_basebody_shapekeys" (short, clear)
- Class name = DLM_OT_migrator_basebody_shapekeys
Update all 6 places in operators.py and 1 in panels.py. I'll leave the docstring in migrator.py as-is (it's internal) unless the user wants that too - they said "the operator" so I'll just change the operator class and UI.
Tool use: **edit_file_v2** • Edit file: T:\Dynamic-Link-Manager\ui\operators.py
Tool use: **edit_file_v2** • Edit file: T:\Dynamic-Link-Manager\ui\operators.py
Tool use: **edit_file_v2** • Edit file: T:\Dynamic-Link-Manager\ui\operators.py
Tool use: **edit_file_v2** • Edit file: T:\Dynamic-Link-Manager\ui\operators.py
Tool use: **edit_file_v2** • Edit file: T:\Dynamic-Link-Manager\ui\operators.py
Tool use: **edit_file_v2** • Edit file: T:\Dynamic-Link-Manager\ui\panels.py
Thought Process
All replacements done. The run_character_migration execute() uses a list of operator callables - I updated the one that was bpy.ops.dlm.migrator_replacement_base_body. Let me verify there are no remaining references and that the steps list is correct.
Tool use: **ripgrep_raw_search**
Parameters:
```json
{
"pattern": "replacement_base_body|basebody_shapekeys",
"path": "T:\\Dynamic-Link-Manager",
"glob": "*.py",
"caseInsensitive": false
}
```
Additional data:
```json
{
"isPruned": true,
"pattern": "replacement_base_body|basebody_shapekeys",
"path": "T:\\Dynamic-Link-Manager",
"outputMode": "content",
"totalFiles": 4,
"totalMatches": 12,
"topFiles": [
{
"uri": "ui\\panels.py",
"matchCount": 1
},
{
"uri": "ui\\operators.py",
"matchCount": 5
},
{
"uri": "ui/operators.py",
"matchCount": 5
},
{
"uri": "ui/panels.py",
"matchCount": 1
}
]
}
```
Status: **completed**
---
Thought Process
All references are updated. No old "replacement_base_body" left in the Python files (the ops/migrator.py one is just a docstring for run_step_6, not the operator). Done.
Thought Process
The user is saying that the library override still isn't being created on the mesh. They're referring to something in the terminal that says "shift click to clear the library override and toggle if it can be edited" - so they're describing UI behavior in Blender (likely in the Outliner or data-block menu) where you can make a linked datablock editable. That might be a different operation than `override_create()`.
In Blender:
1. **Library Override** - creates a local override of linked data so you can edit it; changes sync with the library on reload in a defined way.
2. **Make Local** (or "Make Editable") - could be a different thing: e.g. "Make Single User" / copy the data so it's no longer linked, or "Make Library Override" which is override_create.
The "shift click to clear the library override and toggle if it can be edited" sounds like the Outliner's behavior where:
- Click on the library/override icon might "make override" or "make editable"
- Shift+click might clear the override or toggle editability
So the user might need a different Blender API call. Let me search for what "make editable" or "make local" or "toggle editable" does for linked data in Blender Python - it could be that we need to use an operator like `bpy.ops.outliner.id_operation(type='OVERRIDE_LIBRARY_CREATE')` or similar, or there's a specific "make editable" operation.
Actually re-reading again: "shift click to clear the library override and toggle if it can be edited. That's what we need to do." - So they want to do whatever that shift-click does. So we need to find the Blender operator or API that corresponds to "make this linked data editable" in the way the UI does it. That could be:
1. override_create() - which we're already calling
2. Some other operator like lib_override_make_editable or similar
Let me search the web for Blender make linked data editable operator, outliner library override shift click.
Tool use: **read_file_v2** • Read file: c:\Users\Nathan\.cursor\projects\t-Dynamic-Link-Manager\terminals\3.txt
Tool use: **web_search** • Searched web `undefined` • **1** results
| Title | URL | Chunk |
|-------|-----|-------|
| Web search results for query: Blender make linked data editable operator Python override library make editable | | Links:
1. [What context does make_links_data need?](https://blender.stackexchange.com/questions/141338/what-context-does-make-links-data-need)
2. [Edit Linked Library ](https://docs.blender.org/manual/en/3.6/addons/object/edit_linked_library.html)
3. [creating a linked library collection with an override hierarchy in python is near impossible.](https://projects.blender.org/blender/blender/issues/99790)
4. [How to make a blender library override in python](https://blender.stackexchange.com/questions/289245/how-to-make-a-blender-library-override-in-python)
5. [Create Library Override of Data Block](https://blender.stackexchange.com/questions/177650/create-library-override-of-data-block/177657)
# Making Linked Data Editable in Blender with Python
## Library Override Methods
To make linked data editable in Blender via Python, use the low-level API instead of operators when possible:
**For collections:**
```python
col = bpy.data.collections[collection_name]
col.override_hierarchy_create(bpy.context.scene, bpy.context.view_layer, do_fully_editable=True)
```[4]
**For individual data blocks:**
```python
obj = bpy.context.view_layer.objects.active
obj.data.override_create(remap_local_usages=True)
```[5]
## Context Override for Operators
When using operators like `bpy.ops.object.make_links_data`, proper context override is critical. You need to override the window, screen, area, and region:[1]
```python
import bpy
area_type = 'VIEW_3D'
areas = [area for area in bpy.context.window.screen.areas if area.type == area_type]
override = \{
'window': bpy.context.window,
'screen': bpy.context.window.screen,
'area': areas[0],
'region': [region for region in areas[0].regions if region.type == 'WINDOW'][0]
\}
```[1]
## Making Overrides Editable
For making library overrides editable, use the `outliner.id_operation` with proper context override:[3]
```python
for window in bpy.context.window_manager.windows:
screen = window.screen
for area in screen.areas:
if area.type == 'OUTLINER':
with bpy.context.temp_override(window=window, area=area):
bpy.ops.outliner.id_operation(type='OVERRIDE_LIBRARY_MAKE_EDITABLE')
break
```[3]
The direct API approach using `override_hierarchy_create()` is generally more reliable than operators for automation.[4] |
---
Thought Process
The search found that there's an operator `bpy.ops.outliner.id_operation(type='OVERRIDE_LIBRARY_MAKE_EDITABLE')` - but that runs in Outliner context and operates on the selection. So the "shift click" to make editable might be triggering something like OVERRIDE_LIBRARY_MAKE_EDITABLE or creating an override in a different way.
There's also `override_hierarchy_create` for collections with `do_fully_editable=True`. For a single mesh data block, we're using `override_create(remap_local_usages=True)`.
Let me search more specifically for Blender outliner id_operation OVERRIDE_LIBRARY and what types exist, and whether there's a "create override" vs "make editable" distinction.
Tool use: **web_search** • Searched web `undefined` • **1** results
| Title | URL | Chunk |
|-------|-----|-------|
| Web search results for query: Blender outliner id_operation OVERRIDE_LIBRARY type Python create hierarchy | | Links:
1. [IDOverrideLibrary(bpy_struct) ¶](https://docs.blender.org/api/current/bpy.types.IDOverrideLibrary.html)
2. [IDOverrideLibraryPropertyOperations(bpy_struct) ¶](https://docs.blender.org/api/current/bpy.types.IDOverrideLibraryPropertyOperations.html)
3. [Outliner Operators — Blender Python API](https://docs.blender.org/api/2.80/bpy.ops.outliner.html)
4. [creating a linked library collection with an override hierarchy in python is near impossible.](https://projects.blender.org/blender/blender/issues/99790)
5. [Outliner, Library Overrides: List child objects under parents · f9a805164a](https://projects.blender.org/blender/blender/commit/f9a805164a944c3b5762f07e535536b9f425651f)
# Blender Outliner ID_Operation and Override Library
Based on the search results, here's what you need to know about working with `id_operation` and library overrides in Blender Python:
## ID_Operation Types
The `bpy.ops.outliner.id_operation()` operator supports the following types:[3]
- `UNLINK`
- `LOCAL`
- `SINGLE`
- `DELETE`
- `REMAP`
- `COPY`
- `PASTE`
- `ADD_FAKE`
- `CLEAR_FAKE`
- `RENAME`
- `SELECT_LINKED`
**Important Note:** `OVERRIDE_LIBRARY_MAKE_EDITABLE` is not a valid enum value for this operator in version 3.2.2, despite being available in the UI when run from the text editor.[4]
## Working with Library Overrides
To work with library overrides in Python, use the `IDOverrideLibrary` class and related types like `IDOverrideLibraryPropertyOperations`.[1][2] These provide the core functionality for managing library override hierarchies programmatically.
## Context Requirements
When calling outliner operators from an addon, you need proper context setup:[4] Use `bpy.context.temp_override()` to set the window and outliner area context, as the operator requires an active outliner editor context to function properly.
## Hierarchy Creation
Library override hierarchies can be displayed and managed through the Outliner's tree display system, which has dedicated support for listing child objects under parent objects in override hierarchies.[5] |
---
Tool use: **web_search** • Searched web `undefined` • **1** results
| Title | URL | Chunk |
|-------|-----|-------|
| Web search results for query: Blender override_hierarchy_create do_fully_editable mesh object Python | | Links:
1. [How to make a blender library override in python](https://blender.stackexchange.com/questions/289245/how-to-make-a-blender-library-override-in-python)
2. [IDOverrideLibrary(bpy_struct) ¶](https://docs.blender.org/api/current/bpy.types.IDOverrideLibrary.html)
3. [BMesh Module (bmesh) ¶](https://docs.blender.org/api/current/bmesh.html?highlight=from_edit_mesh)
4. [Operators (bpy.ops) ](https://docs.blender.org/api/3.6/bpy.ops.html)
5. [Modes and Mesh Access - Blender Python API](https://docs.blender.org/api/current/info_gotchas_meshes.html)
# Blender `override_hierarchy_create` with `do_fully_editable` for Mesh Objects
To create a library override in Python for a mesh object with full editability, use the `override_hierarchy_create()` method on a collection:[1]
```python
col = bpy.data.collections[collection_name]
col.override_hierarchy_create(bpy.context.scene, bpy.context.view_layer, do_fully_editable=True)
```
This method is a lower-level API alternative to the `bpy.ops.object.make_override_library` operator.[1] The `do_fully_editable=True` parameter makes all objects in the hierarchy fully editable.[1]
**Note:** This approach makes everything in the collection editable. If you need more granular control over which specific objects become editable, the `do_fully_editable` parameter may not provide that selectivity.[1]
For reference, the method is documented in the [Blender Python API](https://docs.blender.org/api/current/bpy.types.ID.html#bpy.types.ID.override_hierarchy_create).[1] |
---
Thought Process
So there are two different things:
1. `override_create()` on an ID - creates a library override of that single datablock.
2. `override_hierarchy_create()` on a **collection** - creates overrides for the whole hierarchy, and `do_fully_editable=True` makes everything in it editable (which might be what the UI "shift click" does - make the override "fully editable" so you can edit it).
So maybe the issue is:
- We create an override with `override_create()`, but the override might be created in a "non-editable" or restricted state by default.
- The UI "shift click to toggle if it can be edited" might set the override to "fully editable" - and that could be a property on the override (override_library) like `hierarchy_root` or something that controls editability.
Let me search for "fully editable" override Blender Python.
Tool use: **web_search** • Searched web `undefined` • **1** results
| Title | URL | Chunk |
|-------|-----|-------|
| Web search results for query: Blender library override "fully editable" Python ID.override_library | | Links:
1. [IDOverrideLibrary(bpy_struct) ¶](https://docs.blender.org/api/current/bpy.types.IDOverrideLibrary.html)
2. [How to make a blender library override in python](https://blender.stackexchange.com/questions/289245/how-to-make-a-blender-library-override-in-python)
3. [Library Overrides ¶](https://developer.blender.org/docs/features/core/overrides/library/)
4. [No way to make a library override on a collection 'editable' from the outliner or properties](https://projects.blender.org/blender/blender/issues/109808)
5. [LibOverride: Make fully editable when creating an experimental user setting. · 7cfea48752](https://projects.blender.org/blender/blender/commit/7cfea48752ebc544104d57d19736c201a98bc3cd)
# Blender Library Override "Fully Editable" Python
To make a library override "fully editable" in Python, use the `override_hierarchy_create()` method with the `do_fully_editable` parameter:[2]
```python
col = bpy.data.collections[collection_name]
col.override_hierarchy_create(bpy.context.scene, bpy.context.view_layer, do_fully_editable=True)
```
This method creates a library override on a collection and all its dependencies.[2] The `do_fully_editable=True` parameter marks all properties in the override hierarchy as editable, rather than only tracking which properties have been locally modified.[3]
**Note:** This approach will make everything in the hierarchy editable. If you need finer control over which specific properties are editable, you would need to work with the lower-level `IDOverrideLibrary` structure directly, though this is more complex.[1][2]
The `override_hierarchy_create()` method is documented in the [Blender Python API reference](https://docs.blender.org/api/current/bpy.types.ID.html#bpy.types.ID.override_hierarchy_create).[2] |
---
Tool use: **ripgrep_raw_search**
Parameters:
```json
{
"pattern": "override_create|override_hierarchy",
"path": "T:\\Dynamic-Link-Manager\\ops\\migrator.py",
"contextBefore": 0,
"contextAfter": 2,
"caseInsensitive": false
}
```
Additional data:
```json
{
"isPruned": true,
"pattern": "override_create|override_hierarchy",
"path": "T:\\Dynamic-Link-Manager\\ops\\migrator.py",
"outputMode": "content",
"totalFiles": 1,
"totalMatches": 2,
"topFiles": [
{
"uri": "ops\\migrator.py",
"matchCount": 6
}
]
}
```
Status: **completed**
---
Thought Process
So the key insight is:
1. `override_hierarchy_create()` is for **collections** - it takes a scene and view_layer and creates overrides for the whole hierarchy with `do_fully_editable=True` to make everything editable.
2. For a single object or mesh, we use `override_create()`.
The user said "shift click to clear the library override and **toggle if it can be edited**". So there are two actions:
- One click: maybe "create override" or "make override"
- Shift+click: "toggle if it can be edited"
So "make editable" might mean: take an existing override and mark it as fully editable. That could be a different API - perhaps on the override we need to set something like `id.override_library.do_fully_editable` or similar after creating the override.
Let me check the Blender API for ID.override_library and do_fully_editable.
Tool use: **web_fetch**
Parameters:
```json
{
"url": "https://docs.blender.org/api/current/bpy.types.IDOverrideLibrary.html"
}
```
Result:
```json
{
"url": "https://docs.blender.org/api/current/bpy.types.IDOverrideLibrary.html",
"markdown": "IDOverrideLibrary(bpy_struct) - Blender Python API\n\n# IDOverrideLibrary(bpy_struct)¶\n\nbase class — [bpy_struct](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct)\n\nclass bpy.types.IDOverrideLibrary(bpy_struct)¶\n\nStruct gathering all data needed by overridden linked IDs\n\nhierarchy_root¶\n\nLibrary override ID used as root of the override hierarchy this ID is a member of\n\nType:\n\n[ID](https://docs.blender.org/api/current/bpy.types.ID.html#bpy.types.ID), (readonly)\n\nis_in_hierarchy¶\n\nWhether this library override is defined as part of a library hierarchy, or as a single, isolated and autonomous override\n\nType:\n\nboolean, default True\n\nis_system_override¶\n\nWhether this library override exists only for the override hierarchy, or if it is actually editable by the user\n\nType:\n\nboolean, default False\n\nproperties¶\n\nList of overridden properties\n\nType:\n\n[IDOverrideLibraryProperties](https://docs.blender.org/api/current/bpy.types.IDOverrideLibraryProperties.html#bpy.types.IDOverrideLibraryProperties) [bpy_prop_collection](https://docs.blender.org/api/current/bpy.types.bpy_prop_collection.html#bpy.types.bpy_prop_collection) of [IDOverrideLibraryProperty](https://docs.blender.org/api/current/bpy.types.IDOverrideLibraryProperty.html#bpy.types.IDOverrideLibraryProperty), (readonly)\n\nreference¶\n\nLinked ID used as reference by this override\n\nType:\n\n[ID](https://docs.blender.org/api/current/bpy.types.ID.html#bpy.types.ID), (readonly)\n\noperations_update()¶\n\nUpdate the library override operations based on the differences between this override ID and its reference\n\nreset(*, do_hierarchy=True, set_system_override=False)¶\n\nReset this override to match again its linked reference ID\n\nParameters:\n\ndo_hierarchy (boolean, (optional)) – Also reset all the dependencies of this override to match their reference linked IDs\n\nset_system_override (boolean, (optional)) – Reset all user-editable overrides as (non-editable) system overrides\n\ndestroy(*, do_hierarchy=True)¶\n\nDelete this override ID and remap its usages to its linked reference ID instead\n\nParameters:\n\ndo_hierarchy (boolean, (optional)) – Also delete all the dependencies of this override and remap their usages to their reference linked IDs\n\nresync(scene, *, view_layer=None, residual_storage=None, do_hierarchy_enforce=False, do_whole_hierarchy=False)¶\n\nResync the data-block and its sub-hierarchy, or the whole hierarchy if requested\n\nParameters:\n\nscene ([Scene](https://docs.blender.org/api/current/bpy.types.Scene.html#bpy.types.Scene), (never None)) – The scene to operate in (for contextual things like keeping active object active, ensuring all overridden objects remain instantiated, etc.)\n\nview_layer ([ViewLayer](https://docs.blender.org/api/current/bpy.types.ViewLayer.html#bpy.types.ViewLayer), (optional)) – The view layer to operate in (same usage as the`scene` data, in case it is not provided the scene’s collection will be used instead)\n\nresidual_storage ([Collection](https://docs.blender.org/api/current/bpy.types.Collection.html#bpy.types.Collection), (optional)) – Collection where to store objects that are instantiated in any other collection anymore (garbage collection, will be created if needed and none is provided)\n\ndo_hierarchy_enforce (boolean, (optional)) – Enforce restoring the dependency hierarchy between data-blocks to match the one from the reference linked hierarchy (WARNING: if some ID pointers have been purposely overridden, these will be reset to their default value)\n\ndo_whole_hierarchy (boolean, (optional)) – Resync the whole hierarchy this data-block belongs to, not only its own sub-hierarchy\n\nReturns:\n\nSuccess, Whether the resync process was successful or not\n\nReturn type:\n\nboolean\n\nclassmethod bl_rna_get_subclass(id, default=None, /)¶ Parameters:\n\nid (str) – The RNA type identifier.\n\nReturns:\n\nThe RNA type or default when not found.\n\nReturn type:\n\n[bpy.types.Struct](https://docs.blender.org/api/current/bpy.types.Struct.html#bpy.types.Struct) subclass\n\nclassmethod bl_rna_get_subclass_py(id, default=None, /)¶ Parameters:\n\nid (str) – The RNA type identifier.\n\nReturns:\n\nThe class or default when not found.\n\nReturn type:\n\ntype\n\n## Inherited Properties¶\n\n[bpy_struct.id_data](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.id_data)\n\n## Inherited Functions¶\n\n[bpy_struct.as_pointer](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.as_pointer)\n\n[bpy_struct.driver_add](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.driver_add)\n\n[bpy_struct.driver_remove](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.driver_remove)\n\n[bpy_struct.get](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.get)\n\n[bpy_struct.id_properties_clear](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.id_properties_clear)\n\n[bpy_struct.id_properties_ensure](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.id_properties_ensure)\n\n[bpy_struct.id_properties_ui](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.id_properties_ui)\n\n[bpy_struct.is_property_hidden](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.is_property_hidden)\n\n[bpy_struct.is_property_overridable_library](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.is_property_overridable_library)\n\n[bpy_struct.is_property_readonly](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.is_property_readonly)\n\n[bpy_struct.is_property_set](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.is_property_set)\n\n[bpy_struct.items](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.items)\n\n[bpy_struct.keyframe_delete](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.keyframe_delete)\n\n[bpy_struct.keyframe_insert](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.keyframe_insert)\n\n[bpy_struct.keys](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.keys)\n\n[bpy_struct.path_from_id](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.path_from_id)\n\n[bpy_struct.path_from_module](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.path_from_module)\n\n[bpy_struct.path_resolve](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.path_resolve)\n\n[bpy_struct.pop](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.pop)\n\n[bpy_struct.property_overridable_library_set](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.property_overridable_library_set)\n\n[bpy_struct.property_unset](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.property_unset)\n\n[bpy_struct.rna_ancestors](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.rna_ancestors)\n\n[bpy_struct.type_recast](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.type_recast)\n\n[bpy_struct.values](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.values)\n\n## References¶\n\n[ID.override_library](https://docs.blender.org/api/current/bpy.types.ID.html#bpy.types.ID.override_library)"
}
```
User decision: **accepted**
Status: **completed**
---
Tool use: **web_fetch**
Parameters:
```json
{
"url": "https://docs.blender.org/api/current/bpy.types.ID.html"
}
```
Result:
```json
{
"url": "https://docs.blender.org/api/current/bpy.types.ID.html",
"markdown": "ID(bpy_struct) - Blender Python API\n\n# ID(bpy_struct)¶\n\nbase class — [bpy_struct](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct)\n\nsubclasses — [Action](https://docs.blender.org/api/current/bpy.types.Action.html#bpy.types.Action), [Annotation](https://docs.blender.org/api/current/bpy.types.Annotation.html#bpy.types.Annotation), [Armature](https://docs.blender.org/api/current/bpy.types.Armature.html#bpy.types.Armature), [Brush](https://docs.blender.org/api/current/bpy.types.Brush.html#bpy.types.Brush), [CacheFile](https://docs.blender.org/api/current/bpy.types.CacheFile.html#bpy.types.CacheFile), [Camera](https://docs.blender.org/api/current/bpy.types.Camera.html#bpy.types.Camera), [Collection](https://docs.blender.org/api/current/bpy.types.Collection.html#bpy.types.Collection), [Curve](https://docs.blender.org/api/current/bpy.types.Curve.html#bpy.types.Curve), [Curves](https://docs.blender.org/api/current/bpy.types.Curves.html#bpy.types.Curves), [FreestyleLineStyle](https://docs.blender.org/api/current/bpy.types.FreestyleLineStyle.html#bpy.types.FreestyleLineStyle), [GreasePencil](https://docs.blender.org/api/current/bpy.types.GreasePencil.html#bpy.types.GreasePencil), [Image](https://docs.blender.org/api/current/bpy.types.Image.html#bpy.types.Image), [Key](https://docs.blender.org/api/current/bpy.types.Key.html#bpy.types.Key), [Lattice](https://docs.blender.org/api/current/bpy.types.Lattice.html#bpy.types.Lattice), [Library](https://docs.blender.org/api/current/bpy.types.Library.html#bpy.types.Library), [Light](https://docs.blender.org/api/current/bpy.types.Light.html#bpy.types.Light), [LightProbe](https://docs.blender.org/api/current/bpy.types.LightProbe.html#bpy.types.LightProbe), [Mask](https://docs.blender.org/api/current/bpy.types.Mask.html#bpy.types.Mask), [Material](https://docs.blender.org/api/current/bpy.types.Material.html#bpy.types.Material), [Mesh](https://docs.blender.org/api/current/bpy.types.Mesh.html#bpy.types.Mesh), [MetaBall](https://docs.blender.org/api/current/bpy.types.MetaBall.html#bpy.types.MetaBall), [MovieClip](https://docs.blender.org/api/current/bpy.types.MovieClip.html#bpy.types.MovieClip), [NodeTree](https://docs.blender.org/api/current/bpy.types.NodeTree.html#bpy.types.NodeTree), [Object](https://docs.blender.org/api/current/bpy.types.Object.html#bpy.types.Object), [PaintCurve](https://docs.blender.org/api/current/bpy.types.PaintCurve.html#bpy.types.PaintCurve), [Palette](https://docs.blender.org/api/current/bpy.types.Palette.html#bpy.types.Palette), [ParticleSettings](https://docs.blender.org/api/current/bpy.types.ParticleSettings.html#bpy.types.ParticleSettings), [PointCloud](https://docs.blender.org/api/current/bpy.types.PointCloud.html#bpy.types.PointCloud), [Scene](https://docs.blender.org/api/current/bpy.types.Scene.html#bpy.types.Scene), [Screen](https://docs.blender.org/api/current/bpy.types.Screen.html#bpy.types.Screen), [Sound](https://docs.blender.org/api/current/bpy.types.Sound.html#bpy.types.Sound), [Speaker](https://docs.blender.org/api/current/bpy.types.Speaker.html#bpy.types.Speaker), [Text](https://docs.blender.org/api/current/bpy.types.Text.html#bpy.types.Text), [Texture](https://docs.blender.org/api/current/bpy.types.Texture.html#bpy.types.Texture), [VectorFont](https://docs.blender.org/api/current/bpy.types.VectorFont.html#bpy.types.VectorFont), [Volume](https://docs.blender.org/api/current/bpy.types.Volume.html#bpy.types.Volume), [WindowManager](https://docs.blender.org/api/current/bpy.types.WindowManager.html#bpy.types.WindowManager), [WorkSpace](https://docs.blender.org/api/current/bpy.types.WorkSpace.html#bpy.types.WorkSpace), [World](https://docs.blender.org/api/current/bpy.types.World.html#bpy.types.World)\n\nclass bpy.types.ID(bpy_struct)¶\n\nBase type for data-blocks, defining a unique name, linking from other libraries and garbage collection\n\nasset_data¶\n\nAdditional data for an asset data-block\n\nType:\n\n[AssetMetaData](https://docs.blender.org/api/current/bpy.types.AssetMetaData.html#bpy.types.AssetMetaData)\n\nid_type¶\n\nType identifier of this data-block\n\nType:\n\nenum in [Id Type Items](https://docs.blender.org/api/current/bpy_types_enum_items/id_type_items.html#rna-enum-id-type-items), default`'ACTION'`, (readonly)\n\nis_editable¶\n\nThis data-block is editable in the user interface. Linked data-blocks are not editable, except if they were loaded as editable assets.\n\nType:\n\nboolean, default False, (readonly)\n\nis_embedded_data¶\n\nThis data-block is not an independent one, but is actually a sub-data of another ID (typical example: root node trees or master collections)\n\nType:\n\nboolean, default False, (readonly)\n\nis_evaluated¶\n\nWhether this ID is runtime-only, evaluated data-block, or actual data from .blend file\n\nType:\n\nboolean, default False, (readonly)\n\nis_library_indirect¶\n\nIs this ID block linked indirectly\n\nType:\n\nboolean, default False, (readonly)\n\nis_linked_packed¶\n\nThis data-block is linked and packed into the .blend file\n\nType:\n\nboolean, default False, (readonly)\n\nis_missing¶\n\nThis data-block is a place-holder for missing linked data (i.e. it is [an override of] a linked data that could not be found anymore)\n\nType:\n\nboolean, default False, (readonly)\n\nis_runtime_data¶\n\nThis data-block is runtime data, i.e. it won’t be saved in .blend file. Note that e.g. evaluated IDs are always runtime, so this value is only editable for data-blocks in Main data-base.\n\nType:\n\nboolean, default False\n\nlibrary¶\n\nLibrary file the data-block is linked from\n\nType:\n\n[Library](https://docs.blender.org/api/current/bpy.types.Library.html#bpy.types.Library), (readonly)\n\nlibrary_weak_reference¶\n\nWeak reference to a data-block in another library .blend file (used to re-use already appended data instead of appending new copies)\n\nType:\n\n[LibraryWeakReference](https://docs.blender.org/api/current/bpy.types.LibraryWeakReference.html#bpy.types.LibraryWeakReference), (readonly)\n\nname¶\n\nUnique data-block ID name (within a same type and library)\n\nType:\n\nstring, default “”, (never None)\n\nname_full¶\n\nUnique data-block ID name, including library one if any\n\nType:\n\nstring, default “”, (readonly, never None)\n\noriginal¶\n\nActual data-block from .blend file (Main database) that generated that evaluated one\n\nType:\n\n`ID`, (readonly)\n\noverride_library¶\n\nLibrary override data\n\nType:\n\n[IDOverrideLibrary](https://docs.blender.org/api/current/bpy.types.IDOverrideLibrary.html#bpy.types.IDOverrideLibrary), (readonly)\n\npreview¶\n\nPreview image and icon of this data-block (always None if not supported for this type of data)\n\nType:\n\n[ImagePreview](https://docs.blender.org/api/current/bpy.types.ImagePreview.html#bpy.types.ImagePreview), (readonly)\n\nsession_uid¶\n\nA session-wide unique identifier for the data block that remains the same across renames and internal reallocations, unchanged when reloading the file\n\nType:\n\nint in [-inf, inf], default 0, (readonly)\n\ntag¶\n\nTools can use this to tag data for their own purposes (initial state is undefined)\n\nType:\n\nboolean, default False\n\nuse_extra_user¶\n\nIndicates whether an extra user is set or not (mainly for internal/debug usages)\n\nType:\n\nboolean, default False\n\nuse_fake_user¶\n\nSave this data-block even if it has no users\n\nType:\n\nboolean, default False\n\nusers¶\n\nNumber of times this data-block is referenced\n\nType:\n\nint in [0, inf], default 0, (readonly)\n\nbl_system_properties_get(*, do_create=False)¶\n\nDEBUG ONLY. Internal access to runtime-defined RNA data storage, intended solely for testing and debugging purposes. Do not access it in regular scripting work, and in particular, do not assume that it contains writable data\n\nParameters:\n\ndo_create (boolean, (optional)) – Ensure that system properties are created if they do not exist yet\n\nReturns:\n\nThe system properties root container, or None if there are no system properties stored in this data yet, and its creation was not requested\n\nReturn type:\n\n[PropertyGroup](https://docs.blender.org/api/current/bpy.types.PropertyGroup.html#bpy.types.PropertyGroup)\n\nrename(name, *, mode='NEVER')¶\n\nMore refined handling in case the new name collides with another ID’s name\n\nParameters:\n\nname (string, (never None)) – New name to rename the ID to, if empty will re-use the current ID name\n\nmode (enum in [`'NEVER'`,`'ALWAYS'`,`'SAME_ROOT'`], (optional)) –\n\nHow to handle name collision, in case the requested new name is already used by another ID of the same type\n\n`NEVER` Never Rename – Never rename an existing ID whose name would conflict, the currently renamed ID will get a numeric suffix appended to its new name.\n\n`ALWAYS` Always Rename – Always rename an existing ID whose name would conflict, ensuring that the currently renamed ID will get requested name.\n\n`SAME_ROOT` Rename If Same Root – Only rename an existing ID whose name would conflict if its name root (everything besides the numerical suffix) is the same as the existing name of the currently renamed ID.\n\nReturns:\n\nHow did the renaming of the data-block went on\n\n`UNCHANGED` Unchanged – The ID was not renamed, e.g. because it is already named as requested.\n\n`UNCHANGED_COLLISION` Unchanged Due to Collision – The ID was not renamed, because requested name would have collided with another existing ID’s name, and the automatically adjusted name was the same as the current ID’s name.\n\n`RENAMED_NO_COLLISION` Renamed Without Collision – The ID was renamed as requested, without creating any name collision.\n\n`RENAMED_COLLISION_ADJUSTED` Renamed With Collision – The ID was renamed with adjustment of the requested name, to avoid a name collision.\n\n`RENAMED_COLLISION_FORCED` Renamed Enforced With Collision – The ID was renamed as requested, also renaming another ID to avoid a name collision.\n\nReturn type:\n\nenum in [`'UNCHANGED'`,`'UNCHANGED_COLLISION'`,`'RENAMED_NO_COLLISION'`,`'RENAMED_COLLISION_ADJUSTED'`,`'RENAMED_COLLISION_FORCED'`]\n\nevaluated_get(depsgraph)¶\n\nGet corresponding evaluated ID from the given dependency graph. Note that this does not ensure the dependency graph is fully evaluated, it just returns the result of the last evaluation.\n\nParameters:\n\ndepsgraph ([Depsgraph](https://docs.blender.org/api/current/bpy.types.Depsgraph.html#bpy.types.Depsgraph), (never None)) – Dependency graph to perform lookup in\n\nReturns:\n\nNew copy of the ID\n\nReturn type:\n\n`ID`\n\ncopy()¶\n\nCreate a copy of this data-block (not supported for all data-blocks). The result is added to the Blend-File Data (Main database), with all references to other data-blocks ensured to be from within the same Blend-File Data.\n\nReturns:\n\nNew copy of the ID\n\nReturn type:\n\n`ID`\n\nasset_mark()¶\n\nEnable easier reuse of the data-block through the Asset Browser, with the help of customizable metadata (like previews, descriptions and tags)\n\nasset_clear()¶\n\nDelete all asset metadata and turn the asset data-block back into a normal data-block\n\nasset_generate_preview()¶\n\nGenerate preview image (might be scheduled in a background thread)\n\noverride_create(*, remap_local_usages=False)¶\n\nCreate an overridden local copy of this linked data-block (not supported for all data-blocks)\n\nParameters:\n\nremap_local_usages (boolean, (optional)) – Whether local usages of the linked ID should be remapped to the new library override of it\n\nReturns:\n\nNew overridden local copy of the ID\n\nReturn type:\n\n`ID`\n\noverride_hierarchy_create(scene, view_layer, *, reference=None, do_fully_editable=False)¶\n\nCreate an overridden local copy of this linked data-block, and most of its dependencies when it is a Collection or and Object\n\nParameters:\n\nscene ([Scene](https://docs.blender.org/api/current/bpy.types.Scene.html#bpy.types.Scene), (never None)) – In which scene the new overrides should be instantiated\n\nview_layer ([ViewLayer](https://docs.blender.org/api/current/bpy.types.ViewLayer.html#bpy.types.ViewLayer), (never None)) – In which view layer the new overrides should be instantiated\n\nreference (`ID`, (optional)) – Another ID (usually an Object or Collection) used as a hint to decide where to instantiate the new overrides\n\ndo_fully_editable (boolean, (optional)) – Make all library overrides generated by this call fully editable by the user (none will be ‘system overrides’)\n\nReturns:\n\nNew overridden local copy of the root ID\n\nReturn type:\n\n`ID`\n\nuser_clear()¶\n\nClear the user count of a data-block so its not saved, on reload the data will be removed\n\nThis function is for advanced use only, misuse can crash Blender since the user count is used to prevent data being removed when it is used.\n\n```\n# This example shows what _not_ to do, and will crash Blender.\nimport bpy\n\n# Object which is in the scene.\nobj = bpy.data.objects[\"Cube\"]\n\n# Without this, removal would raise an error.\nobj.user_clear()\n\n# Runs without an exception but will crash on redraw.\nbpy.data.objects.remove(obj)\n\n```\n\nuser_remap(new_id)¶\n\nReplace all usage in the .blend file of this ID by new given one\n\nParameters:\n\nnew_id (`ID`, (never None)) – New ID to use\n\nmake_local(*, clear_proxy=True, clear_liboverride=False, clear_asset_data=True)¶\n\nMake this data-block local, return local one (may be a copy of the original, in case it is also indirectly used)\n\nParameters:\n\nclear_proxy (boolean, (optional)) – Deprecated, has no effect\n\nclear_liboverride (boolean, (optional)) – Remove potential library override data from the newly made local data\n\nclear_asset_data (boolean, (optional)) – Remove potential asset metadata so the newly local data-block is not treated as asset data-block and won’t show up in asset libraries\n\nReturns:\n\nThis ID, or the new ID if it was copied\n\nReturn type:\n\n`ID`\n\nuser_of_id(id)¶\n\nCount the number of times that ID uses/references given one\n\nParameters:\n\nid (`ID`, (never None)) – ID to count usages\n\nReturns:\n\nNumber of usages/references of given id by current data-block\n\nReturn type:\n\nint in [0, inf]\n\nanimation_data_create()¶\n\nCreate animation data to this ID, note that not all ID types support this\n\nReturns:\n\nNew animation data or nullptr\n\nReturn type:\n\n[AnimData](https://docs.blender.org/api/current/bpy.types.AnimData.html#bpy.types.AnimData)\n\nanimation_data_clear()¶\n\nClear animation on this ID\n\nupdate_tag(*, refresh={})¶\n\nTag the ID to update its display data, e.g. when calling`bpy.types.Scene.update`\n\nParameters:\n\nrefresh (enum set in {`'OBJECT'`,`'DATA'`,`'TIME'`}, (optional)) – Type of updates to perform\n\npreview_ensure()¶\n\nEnsure that this ID has preview data (if ID type supports it)\n\nReturns:\n\nThe existing or created preview\n\nReturn type:\n\n[ImagePreview](https://docs.blender.org/api/current/bpy.types.ImagePreview.html#bpy.types.ImagePreview)\n\nclassmethod bl_rna_get_subclass(id, default=None, /)¶ Parameters:\n\nid (str) – The RNA type identifier.\n\nReturns:\n\nThe RNA type or default when not found.\n\nReturn type:\n\n[bpy.types.Struct](https://docs.blender.org/api/current/bpy.types.Struct.html#bpy.types.Struct) subclass\n\nclassmethod bl_rna_get_subclass_py(id, default=None, /)¶ Parameters:\n\nid (str) – The RNA type identifier.\n\nReturns:\n\nThe class or default when not found.\n\nReturn type:\n\ntype\n\n## Inherited Properties¶\n\n[bpy_struct.id_data](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.id_data)\n\n## Inherited Functions¶\n\n[bpy_struct.as_pointer](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.as_pointer)\n\n[bpy_struct.driver_add](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.driver_add)\n\n[bpy_struct.driver_remove](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.driver_remove)\n\n[bpy_struct.get](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.get)\n\n[bpy_struct.id_properties_clear](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.id_properties_clear)\n\n[bpy_struct.id_properties_ensure](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.id_properties_ensure)\n\n[bpy_struct.id_properties_ui](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.id_properties_ui)\n\n[bpy_struct.is_property_hidden](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.is_property_hidden)\n\n[bpy_struct.is_property_overridable_library](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.is_property_overridable_library)\n\n[bpy_struct.is_property_readonly](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.is_property_readonly)\n\n[bpy_struct.is_property_set](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.is_property_set)\n\n[bpy_struct.items](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.items)\n\n[bpy_struct.keyframe_delete](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.keyframe_delete)\n\n[bpy_struct.keyframe_insert](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.keyframe_insert)\n\n[bpy_struct.keys](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.keys)\n\n[bpy_struct.path_from_id](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.path_from_id)\n\n[bpy_struct.path_from_module](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.path_from_module)\n\n[bpy_struct.path_resolve](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.path_resolve)\n\n[bpy_struct.pop](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.pop)\n\n[bpy_struct.property_overridable_library_set](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.property_overridable_library_set)\n\n[bpy_struct.property_unset](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.property_unset)\n\n[bpy_struct.rna_ancestors](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.rna_ancestors)\n\n[bpy_struct.type_recast](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.type_recast)\n\n[bpy_struct.values](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.values)\n\n## References¶\n\n[bpy.context.annotation_data_owner](https://docs.blender.org/api/current/bpy.context.html#bpy.context.annotation_data_owner)\n\n[bpy.context.id](https://docs.blender.org/api/current/bpy.context.html#bpy.context.id)\n\n[bpy.context.selected_ids](https://docs.blender.org/api/current/bpy.context.html#bpy.context.selected_ids)\n\n[bpy.context.texture_user](https://docs.blender.org/api/current/bpy.context.html#bpy.context.texture_user)\n\n[Action.fcurve_ensure_for_datablock](https://docs.blender.org/api/current/bpy.types.Action.html#bpy.types.Action.fcurve_ensure_for_datablock)\n\n[ActionSlot.users](https://docs.blender.org/api/current/bpy.types.ActionSlot.html#bpy.types.ActionSlot.users)\n\n[AssetRepresentation.local_id](https://docs.blender.org/api/current/bpy.types.AssetRepresentation.html#bpy.types.AssetRepresentation.local_id)\n\n[BlendData.pack_linked_ids_hierarchy](https://docs.blender.org/api/current/bpy.types.BlendData.html#bpy.types.BlendData.pack_linked_ids_hierarchy)\n\n[BlendData.pack_linked_ids_hierarchy](https://docs.blender.org/api/current/bpy.types.BlendData.html#bpy.types.BlendData.pack_linked_ids_hierarchy)\n\n[BlendDataObjects.new](https://docs.blender.org/api/current/bpy.types.BlendDataObjects.html#bpy.types.BlendDataObjects.new)\n\n[BlendImportContextItem.id](https://docs.blender.org/api/current/bpy.types.BlendImportContextItem.html#bpy.types.BlendImportContextItem.id)\n\n[BlendImportContextItem.library_override_id](https://docs.blender.org/api/current/bpy.types.BlendImportContextItem.html#bpy.types.BlendImportContextItem.library_override_id)\n\n[BlendImportContextItem.reusable_local_id](https://docs.blender.org/api/current/bpy.types.BlendImportContextItem.html#bpy.types.BlendImportContextItem.reusable_local_id)\n\n[Depsgraph.id_eval_get](https://docs.blender.org/api/current/bpy.types.Depsgraph.html#bpy.types.Depsgraph.id_eval_get)\n\n[Depsgraph.id_eval_get](https://docs.blender.org/api/current/bpy.types.Depsgraph.html#bpy.types.Depsgraph.id_eval_get)\n\n[Depsgraph.ids](https://docs.blender.org/api/current/bpy.types.Depsgraph.html#bpy.types.Depsgraph.ids)\n\n[DepsgraphUpdate.id](https://docs.blender.org/api/current/bpy.types.DepsgraphUpdate.html#bpy.types.DepsgraphUpdate.id)\n\n[DopeSheet.source](https://docs.blender.org/api/current/bpy.types.DopeSheet.html#bpy.types.DopeSheet.source)\n\n[DriverTarget.id](https://docs.blender.org/api/current/bpy.types.DriverTarget.html#bpy.types.DriverTarget.id)\n\n`ID.copy`\n\n`ID.evaluated_get`\n\n`ID.make_local`\n\n`ID.original`\n\n`ID.override_create`\n\n`ID.override_hierarchy_create`\n\n`ID.override_hierarchy_create`\n\n`ID.user_of_id`\n\n`ID.user_remap`\n\n[IDOverrideLibrary.hierarchy_root](https://docs.blender.org/api/current/bpy.types.IDOverrideLibrary.html#bpy.types.IDOverrideLibrary.hierarchy_root)\n\n[IDOverrideLibrary.reference](https://docs.blender.org/api/current/bpy.types.IDOverrideLibrary.html#bpy.types.IDOverrideLibrary.reference)\n\n[IDOverrideLibraryPropertyOperation.subitem_local_id](https://docs.blender.org/api/current/bpy.types.IDOverrideLibraryPropertyOperation.html#bpy.types.IDOverrideLibraryPropertyOperation.subitem_local_id)\n\n[IDOverrideLibraryPropertyOperation.subitem_reference_id](https://docs.blender.org/api/current/bpy.types.IDOverrideLibraryPropertyOperation.html#bpy.types.IDOverrideLibraryPropertyOperation.subitem_reference_id)\n\n[IDOverrideLibraryPropertyOperations.add](https://docs.blender.org/api/current/bpy.types.IDOverrideLibraryPropertyOperations.html#bpy.types.IDOverrideLibraryPropertyOperations.add)\n\n[IDOverrideLibraryPropertyOperations.add](https://docs.blender.org/api/current/bpy.types.IDOverrideLibraryPropertyOperations.html#bpy.types.IDOverrideLibraryPropertyOperations.add)\n\n[IDViewerPathElem.id](https://docs.blender.org/api/current/bpy.types.IDViewerPathElem.html#bpy.types.IDViewerPathElem.id)\n\n[Key.user](https://docs.blender.org/api/current/bpy.types.Key.html#bpy.types.Key.user)\n\n[KeyingSetPath.id](https://docs.blender.org/api/current/bpy.types.KeyingSetPath.html#bpy.types.KeyingSetPath.id)\n\n[KeyingSetPaths.add](https://docs.blender.org/api/current/bpy.types.KeyingSetPaths.html#bpy.types.KeyingSetPaths.add)\n\n[MaskParent.id](https://docs.blender.org/api/current/bpy.types.MaskParent.html#bpy.types.MaskParent.id)\n\n[NodeTree.get_from_context](https://docs.blender.org/api/current/bpy.types.NodeTree.html#bpy.types.NodeTree.get_from_context)\n\n[NodeTree.get_from_context](https://docs.blender.org/api/current/bpy.types.NodeTree.html#bpy.types.NodeTree.get_from_context)\n\n[NodesModifierDataBlock.id](https://docs.blender.org/api/current/bpy.types.NodesModifierDataBlock.html#bpy.types.NodesModifierDataBlock.id)\n\n[Object.data](https://docs.blender.org/api/current/bpy.types.Object.html#bpy.types.Object.data)\n\n[PropertyGroupItem.id](https://docs.blender.org/api/current/bpy.types.PropertyGroupItem.html#bpy.types.PropertyGroupItem.id)\n\n[SpaceFileBrowser.activate_asset_by_id](https://docs.blender.org/api/current/bpy.types.SpaceFileBrowser.html#bpy.types.SpaceFileBrowser.activate_asset_by_id)\n\n[SpaceNodeEditor.id](https://docs.blender.org/api/current/bpy.types.SpaceNodeEditor.html#bpy.types.SpaceNodeEditor.id)\n\n[SpaceNodeEditor.id_from](https://docs.blender.org/api/current/bpy.types.SpaceNodeEditor.html#bpy.types.SpaceNodeEditor.id_from)\n\n[SpaceProperties.pin_id](https://docs.blender.org/api/current/bpy.types.SpaceProperties.html#bpy.types.SpaceProperties.pin_id)\n\n[UILayout.template_action](https://docs.blender.org/api/current/bpy.types.UILayout.html#bpy.types.UILayout.template_action)\n\n[UILayout.template_path_builder](https://docs.blender.org/api/current/bpy.types.UILayout.html#bpy.types.UILayout.template_path_builder)\n\n[UILayout.template_preview](https://docs.blender.org/api/current/bpy.types.UILayout.html#bpy.types.UILayout.template_preview)\n\n[UILayout.template_preview](https://docs.blender.org/api/current/bpy.types.UILayout.html#bpy.types.UILayout.template_preview)"
}
```
User decision: **accepted**
Status: **completed**
---
Thought Process
I see: `is_system_override` - "Whether this library override exists only for the override hierarchy, or if it is actually editable by the user" - so when False, it's editable by the user. So maybe after creating the override we need to ensure is_system_override is False? Let me check the ID.html for override_create and override_hierarchy_create.
Tool use: **ripgrep_raw_search**
Parameters:
```json
{
"pattern": "override_create|override_hierarchy|do_fully",
"path": "C:\\Users\\Nathan\\.cursor\\projects\\t-Dynamic-Link-Manager\\agent-tools\\ce1deae4-c7ce-4345-9a71-2256b4251b6a.txt",
"contextBefore": 0,
"contextAfter": 5,
"caseInsensitive": false
}
```
Additional data:
```json
{
"isPruned": true,
"pattern": "override_create|override_hierarchy|do_fully",
"path": "C:\\Users\\Nathan\\.cursor\\projects\\t-Dynamic-Link-Manager\\agent-tools\\ce1deae4-c7ce-4345-9a71-2256b4251b6a.txt",
"outputMode": "content",
"totalFiles": 1,
"totalMatches": 6,
"topFiles": [
{
"uri": "C:\\Users\\Nathan\\.cursor\\projects\\t-Dynamic-Link-Manager\\agent-tools\\ce1deae4-c7ce-4345-9a71-2256b4251b6a.txt",
"matchCount": 28
}
]
}
```
Status: **completed**
---
Thought Process
So:
- `override_create(remap_local_usages=False)` - Create an overridden local copy of this linked data-block. Doesn't have do_fully_editable.
- `override_hierarchy_create(scene, view_layer, reference=None, do_fully_editable=False)` - For Collection or Object, creates override and dependencies. **do_fully_editable** - "Make all library overrides generated by this call fully editable by the user (none will be 'system overrides')".
So for a single mesh **object**, we could try `ob.override_hierarchy_create(scene, view_layer, do_fully_editable=True)` instead of `ob.override_create()`. That would create the override with full editability. And the doc says "when it is a Collection or an Object" - so it works on Object! So we could:
1. For the object: use `ob.override_hierarchy_create(context.scene, context.view_layer, do_fully_editable=True)` instead of `ob.override_create()`. That might create the object override and possibly its data as well, and make them fully editable.
2. For the mesh data: if the object hierarchy create doesn't pull in the mesh data, we might still need ob.data.override_create(remap_local_usages=True).
But wait - override_hierarchy_create returns "New overridden local copy of the root ID" - so it might create a new object and we'd be left with a reference to the old linked object. We need to run step 6 in a context where we have context.scene and context.view_layer. The migrator run_step_6 doesn't receive context - it only gets (orig, rep, rep_descendants). So we'd need to pass context to run_step_6 to use override_hierarchy_create.
Let me check - does override_hierarchy_create on an Object require the object to be in the scene? It takes scene and view_layer. So we need to pass context into run_step_6. Let me check the call sites.
Tool use: **read_file_v2** • Read file: T:\Dynamic-Link-Manager\ops\migrator.py
Tool use: **ripgrep_raw_search**
Parameters:
```json
{
"pattern": "run_step_6\\(",
"path": "T:\\Dynamic-Link-Manager",
"caseInsensitive": false
}
```
Additional data:
```json
{
"isPruned": true,
"pattern": "run_step_6\\(",
"path": "T:\\Dynamic-Link-Manager",
"outputMode": "content",
"totalFiles": 6,
"totalMatches": 10,
"topFiles": [
{
"uri": "ui/operators.py",
"matchCount": 1
},
{
"uri": ".specstory\\history\\2026-02-18_23-39Z-character-migrator-workflow-integration.md",
"matchCount": 2
},
{
"uri": "ops\\migrator.py",
"matchCount": 2
},
{
"uri": "ops/migrator.py",
"matchCount": 2
},
{
"uri": ".specstory/history/2026-02-18_23-39Z-character-migrator-workflow-integration.md",
"matchCount": 2
},
{
"uri": "ui\\operators.py",
"matchCount": 1
}
]
}
```
Status: **completed**
---
Thought Process
The Blender API says:
- `override_hierarchy_create(scene, view_layer, *, reference=None, do_fully_editable=False)` on an ID - "Create an overridden local copy of this linked data-block, and most of its dependencies when it is a Collection or an Object"
So for an **Object** (the mesh object), we can call `ob.override_hierarchy_create(scene, view_layer, do_fully_editable=True)`. That would create overrides for the object and "most of its dependencies" - which likely includes the mesh data. And do_fully_editable=True would make them all user-editable (not system overrides).
The catch: the doc says "Returns: New overridden local copy of the root ID". So it might return a new object - meaning the hierarchy might be replaced in the scene. So we'd need to use the returned object for the rest of the step (shape keys, etc.). Let me try adding context to run_step_6 and using override_hierarchy_create on the object when it's linked. That way we create the override the same way as the UI (hierarchy + fully editable).
I'll:
1. Add an optional `context` parameter to run_step_6 so we can pass scene/view_layer when available.
2. When the object is linked and context is provided: call `ob.override_hierarchy_create(context.scene, context.view_layer, do_fully_editable=True)`. The return value is the new override root - we might need to then get the mesh object from the scene again (or the override might be in-place; I need to check). Actually the doc says "New overridden local copy of the root ID" - so it creates a NEW object. So the old `ob` might still point to the linked one, and the new override might be in the collection. So after calling override_hierarchy_create we might need to find the new object in rep_descendants again... Actually when you create an override hierarchy from an object, Blender typically replaces the instance in the scene with the override. So the object we have might get "replaced" - i.e. the same name might now refer to the override. Let me check - actually in Blender, override_hierarchy_create might replace the linked object in the view layer with the override, so ob might become invalid or the override might be a different object. I'll try: call override_hierarchy_create(do_fully_editable=True), then continue with the rest of the loop. If the API replaces in place, ob might now be the override; if it returns a new ID, we might need to use the returned value. The Blender docs say "Returns: New overridden local copy of the root ID" - so we get a new object back. So we should do:
new_ob = ob.override_hierarchy_create(context.scene, context.view_layer, do_fully_editable=True)
ob = new_ob # use the override for shape key assignment
# and then do the shape key action on ob.data (which would now be the override's data)
3. When context is not provided (e.g. run_full_migration), we keep the current override_create() behavior for backward compatibility.
Actually re-reading the user message again: "Ah, it says shift click to clear the library override and toggle if it can be edited. That's what we need to do. Is that a different operation?"
So the user is asking: the UI has a "shift click" that toggles whether the override can be edited. So the operation we need might be "make the override editable" (toggle), not "create the override". So maybe:
1. First we need to create the override (which we're trying to do with override_create).
2. Then we need to make it "editable" - which might be setting is_system_override = False or using some "make editable" API.
But the user said the override "still isn't being created" - so the first step might still be failing. Then they said "shift click ... toggle if it can be edited. That's what we need to do. Is that a different operation?" - so they're asking if we need to do that toggle operation. So maybe:
- Option A: Use override_hierarchy_create(do_fully_editable=True) so the override is created AND made fully editable in one go.
- Option B: After override_create(), call something to make it editable (e.g. set a flag).
Let me try Option A: pass context to run_step_6 and use override_hierarchy_create for the object when it's linked. That should create the override hierarchy (object + mesh data) and make it fully editable. I'll need to update the operator to pass context.
Tool use: **read_file_v2** • Read file: T:\Dynamic-Link-Manager\ui\operators.py
Thought Process
I'll:
1. Change run_step_6 to accept an optional context: run_step_6(orig, rep, rep_descendants, context=None).
2. When context is provided and the object is linked, use ob.override_hierarchy_create(context.scene, context.view_layer, do_fully_editable=True) instead of ob.override_create(). The API says it works on Object and creates override + dependencies (likely including mesh data), and do_fully_editable makes them user-editable.
3. When we use override_hierarchy_create, it returns the new override root - we should use that for the rest of the loop iteration (shape keys etc.). So: new_ob = ob.override_hierarchy_create(...); ob = new_ob. Then we don't need to call ob.data.override_create() separately if the hierarchy create already pulled in the mesh. But if the mesh data is still linked after hierarchy create, we'd still need to override it. Let me try hierarchy create first and see - and only do ob.data.override_create if data is still linked.
4. When context is not provided (e.g. from run_full_migration), keep current behavior (override_create).
5. Update the operator to pass context: run_step_6(orig, rep, rep_descendants, context).
6. Update run_full_migration to pass context when it calls run_step_6.
Tool use: **edit_file_v2** • Edit file: T:\Dynamic-Link-Manager\ops\migrator.py
Thought Process
Now I need to update the call sites to pass context. run_full_migration has context, and the operator has context. So:
1. In ui/operators.py: run_step_6(orig, rep, rep_descendants, context)
2. In ops/migrator.py run_full_migration: run_step_6(orig, rep, rep_descendants, context)
Tool use: **edit_file_v2** • Edit file: T:\Dynamic-Link-Manager\ui\operators.py
Tool use: **edit_file_v2** • Edit file: T:\Dynamic-Link-Manager\ops\migrator.py
Thought Process
override_hierarchy_create returns the new override ID. So after ob = ob.override_hierarchy_create(...), ob is the new override object. But we're iterating over rep_descendants which was computed once - so the list might still contain the old linked object reference. Using list(rep_descendants) so we don't modify the iterable. The new override object might have a different name or be the same - in Blender, when you create an override from a linked object, the override typically replaces the linked instance in the scene, so the object in the collection might now be the override. So "ob" after the call might need to be the returned value for the rest of the block (shape keys etc.). I already set ob = ob.override_hierarchy_create(...) so the rest of the loop uses the override. Good.
One issue: if override_hierarchy_create fails, we fall back to ob.override_create() - but then ob is still the original. If override_create() also fails we pass. Then we check ob.data.library - at that point ob might still be the linked object, so ob.data could still be linked. So we still try ob.data.override_create(remap_local_usages=True). Good.
Tool use: **read_lints**
Parameters:
```json
{
"paths": [
"T:\\Dynamic-Link-Manager\\ops\\migrator.py",
"T:\\Dynamic-Link-Manager\\ui\\operators.py"
]
}
```
Result:
```json
{
"linterErrorsByFile": [
{
"relativeWorkspacePath": "T:\\Dynamic-Link-Manager\\ops\\migrator.py"
},
{
"relativeWorkspacePath": "T:\\Dynamic-Link-Manager\\ui\\operators.py"
}
]
}
```
Status: **completed**
---
Thought Process
All good. Let me summarize for the user.
Thought Process
The user wants to:
1. Add debug output because the base body library override is "still not editable"
2. Make it so the user doesn't need to manually select the object, go to data tab, and shift-click the lib override button
From the conversation summary, the issue is that `ob.data.override_create()` creates a library override but it's not "fully editable" like when the user shift-clicks in the UI. The object-level override was fixed with `override_hierarchy_create(context.scene, context.view_layer, do_fully_editable=True)`.
So the fix is likely:
1. For mesh **data** (ob.data), we need to find the Blender API equivalent of "make override fully editable" - possibly there's a flag on the override or a different method.
2. Add debug prints to see what state the override is in before/after.
Let me search the codebase for how step 6 is implemented and what Blender API might make a library override "fully editable" for ID (mesh data).
Tool use: **ripgrep_raw_search**
Parameters:
```json
{
"pattern": "override_create|override_hierarchy|do_fully_editable",
"path": "T:\\Dynamic-Link-Manager",
"caseInsensitive": false
}
```
Additional data:
```json
{
"isPruned": true,
"pattern": "override_create|override_hierarchy|do_fully_editable",
"path": "T:\\Dynamic-Link-Manager",
"outputMode": "content",
"totalFiles": 4,
"totalMatches": 210,
"topFiles": [
{
"uri": ".specstory\\history\\2026-02-18_23-39Z-character-migrator-workflow-integration.md",
"matchCount": 100
},
{
"uri": ".specstory/history/2026-02-18_23-39Z-character-migrator-workflow-integration.md",
"matchCount": 100
},
{
"uri": "ops/migrator.py",
"matchCount": 5
},
{
"uri": "ops\\migrator.py",
"matchCount": 5
}
]
}
```
Status: **completed**
---
Tool use: **read_file_v2** • Read file: T:\Dynamic-Link-Manager\ops\migrator.py
Thought Process
I need to see the full run_step_6 and the part where we create overrides. The transcript mentioned that "shift-click" makes the override "fully editable" and that there's `override_hierarchy_create(..., do_fully_editable=True)` for objects. I need to find if there's an equivalent for ID (mesh data) - like a "make override fully editable" property or method on the override.
Let me read the rest of migrator.py to see run_step_6 and also search for "fully editable" or "lib_override" in Blender API.
Tool use: **read_file_v2** • Read file: T:\Dynamic-Link-Manager\ops\migrator.py
Tool use: **web_search** • Searched web `undefined` • **1** results
| Title | URL | Chunk |
|-------|-----|-------|
| Web search results for query: Blender Python ID override fully editable lib_override do_fully_editable mesh data | | Links:
1. [IDOverrideLibrary(bpy_struct) - Blender Python API](https://docs.blender.org/api/current/bpy.types.IDOverrideLibrary.html)
2. [Create Library Override of Data Block](https://blender.stackexchange.com/questions/177650/create-library-override-of-data-block/177657)
3. [ID(bpy_struct) - Blender Python API](https://docs.blender.org/api/current/bpy.types.ID.html)
4. [LibOverride: Make fully editable when creating an experimental user setting. · 7cfea48752](https://projects.blender.org/blender/blender/commit/7cfea48752ebc544104d57d19736c201a98bc3cd)
5. [Library Overrides ¶](https://developer.blender.org/docs/features/core/overrides/library/)
# Blender Python Library Override - Fully Editable
To create a fully editable library override in Blender Python, use the `override_create()` method on an ID (data-block) with the `do_fully_editable` parameter.[2][4]
## Basic Usage
```python
obj = bpy.context.view_layer.objects.active
obj.data.override_create(remap_local_usages=True)
```
For mesh data specifically, you would apply this to the mesh object's data property.[2]
## Fully Editable Parameter
The `do_fully_editable` parameter makes the override fully editable when creating it.[4] This can be controlled via:
- An experimental user preference setting: `use_override_new_fully_editable`[4]
- Directly in the operator call with the parameter `do_fully_editable = True`[4]
## Key Concepts
Library overrides create local, editable copies of linked data-blocks.[5] They track which parts were edited, allowing changes from the original library file to merge with overrides.[5] The `IDOverrideLibrary` struct stores override operations and references to the linked source ID.[1][5]
For more details on the `IDOverrideLibrary` class and its methods (like `reset()`, `resync()`, and `operations_update()`), see the Blender Python API documentation.[1] |
---
Thought Process
The web search says `override_create()` can take a `do_fully_editable` parameter. Let me check the Blender API for ID.override_create signature to confirm.
Tool use: **web_fetch**
Parameters:
```json
{
"url": "https://docs.blender.org/api/current/bpy.types.ID.html#bpy.types.ID.override_create"
}
```
Result:
```json
{
"url": "https://docs.blender.org/api/current/bpy.types.ID.html#bpy.types.ID.override_create",
"markdown": "ID(bpy_struct) - Blender Python API\n\n# ID(bpy_struct)¶\n\nbase class — [bpy_struct](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct)\n\nsubclasses — [Action](https://docs.blender.org/api/current/bpy.types.Action.html#bpy.types.Action), [Annotation](https://docs.blender.org/api/current/bpy.types.Annotation.html#bpy.types.Annotation), [Armature](https://docs.blender.org/api/current/bpy.types.Armature.html#bpy.types.Armature), [Brush](https://docs.blender.org/api/current/bpy.types.Brush.html#bpy.types.Brush), [CacheFile](https://docs.blender.org/api/current/bpy.types.CacheFile.html#bpy.types.CacheFile), [Camera](https://docs.blender.org/api/current/bpy.types.Camera.html#bpy.types.Camera), [Collection](https://docs.blender.org/api/current/bpy.types.Collection.html#bpy.types.Collection), [Curve](https://docs.blender.org/api/current/bpy.types.Curve.html#bpy.types.Curve), [Curves](https://docs.blender.org/api/current/bpy.types.Curves.html#bpy.types.Curves), [FreestyleLineStyle](https://docs.blender.org/api/current/bpy.types.FreestyleLineStyle.html#bpy.types.FreestyleLineStyle), [GreasePencil](https://docs.blender.org/api/current/bpy.types.GreasePencil.html#bpy.types.GreasePencil), [Image](https://docs.blender.org/api/current/bpy.types.Image.html#bpy.types.Image), [Key](https://docs.blender.org/api/current/bpy.types.Key.html#bpy.types.Key), [Lattice](https://docs.blender.org/api/current/bpy.types.Lattice.html#bpy.types.Lattice), [Library](https://docs.blender.org/api/current/bpy.types.Library.html#bpy.types.Library), [Light](https://docs.blender.org/api/current/bpy.types.Light.html#bpy.types.Light), [LightProbe](https://docs.blender.org/api/current/bpy.types.LightProbe.html#bpy.types.LightProbe), [Mask](https://docs.blender.org/api/current/bpy.types.Mask.html#bpy.types.Mask), [Material](https://docs.blender.org/api/current/bpy.types.Material.html#bpy.types.Material), [Mesh](https://docs.blender.org/api/current/bpy.types.Mesh.html#bpy.types.Mesh), [MetaBall](https://docs.blender.org/api/current/bpy.types.MetaBall.html#bpy.types.MetaBall), [MovieClip](https://docs.blender.org/api/current/bpy.types.MovieClip.html#bpy.types.MovieClip), [NodeTree](https://docs.blender.org/api/current/bpy.types.NodeTree.html#bpy.types.NodeTree), [Object](https://docs.blender.org/api/current/bpy.types.Object.html#bpy.types.Object), [PaintCurve](https://docs.blender.org/api/current/bpy.types.PaintCurve.html#bpy.types.PaintCurve), [Palette](https://docs.blender.org/api/current/bpy.types.Palette.html#bpy.types.Palette), [ParticleSettings](https://docs.blender.org/api/current/bpy.types.ParticleSettings.html#bpy.types.ParticleSettings), [PointCloud](https://docs.blender.org/api/current/bpy.types.PointCloud.html#bpy.types.PointCloud), [Scene](https://docs.blender.org/api/current/bpy.types.Scene.html#bpy.types.Scene), [Screen](https://docs.blender.org/api/current/bpy.types.Screen.html#bpy.types.Screen), [Sound](https://docs.blender.org/api/current/bpy.types.Sound.html#bpy.types.Sound), [Speaker](https://docs.blender.org/api/current/bpy.types.Speaker.html#bpy.types.Speaker), [Text](https://docs.blender.org/api/current/bpy.types.Text.html#bpy.types.Text), [Texture](https://docs.blender.org/api/current/bpy.types.Texture.html#bpy.types.Texture), [VectorFont](https://docs.blender.org/api/current/bpy.types.VectorFont.html#bpy.types.VectorFont), [Volume](https://docs.blender.org/api/current/bpy.types.Volume.html#bpy.types.Volume), [WindowManager](https://docs.blender.org/api/current/bpy.types.WindowManager.html#bpy.types.WindowManager), [WorkSpace](https://docs.blender.org/api/current/bpy.types.WorkSpace.html#bpy.types.WorkSpace), [World](https://docs.blender.org/api/current/bpy.types.World.html#bpy.types.World)\n\nclass bpy.types.ID(bpy_struct)¶\n\nBase type for data-blocks, defining a unique name, linking from other libraries and garbage collection\n\nasset_data¶\n\nAdditional data for an asset data-block\n\nType:\n\n[AssetMetaData](https://docs.blender.org/api/current/bpy.types.AssetMetaData.html#bpy.types.AssetMetaData)\n\nid_type¶\n\nType identifier of this data-block\n\nType:\n\nenum in [Id Type Items](https://docs.blender.org/api/current/bpy_types_enum_items/id_type_items.html#rna-enum-id-type-items), default`'ACTION'`, (readonly)\n\nis_editable¶\n\nThis data-block is editable in the user interface. Linked data-blocks are not editable, except if they were loaded as editable assets.\n\nType:\n\nboolean, default False, (readonly)\n\nis_embedded_data¶\n\nThis data-block is not an independent one, but is actually a sub-data of another ID (typical example: root node trees or master collections)\n\nType:\n\nboolean, default False, (readonly)\n\nis_evaluated¶\n\nWhether this ID is runtime-only, evaluated data-block, or actual data from .blend file\n\nType:\n\nboolean, default False, (readonly)\n\nis_library_indirect¶\n\nIs this ID block linked indirectly\n\nType:\n\nboolean, default False, (readonly)\n\nis_linked_packed¶\n\nThis data-block is linked and packed into the .blend file\n\nType:\n\nboolean, default False, (readonly)\n\nis_missing¶\n\nThis data-block is a place-holder for missing linked data (i.e. it is [an override of] a linked data that could not be found anymore)\n\nType:\n\nboolean, default False, (readonly)\n\nis_runtime_data¶\n\nThis data-block is runtime data, i.e. it won’t be saved in .blend file. Note that e.g. evaluated IDs are always runtime, so this value is only editable for data-blocks in Main data-base.\n\nType:\n\nboolean, default False\n\nlibrary¶\n\nLibrary file the data-block is linked from\n\nType:\n\n[Library](https://docs.blender.org/api/current/bpy.types.Library.html#bpy.types.Library), (readonly)\n\nlibrary_weak_reference¶\n\nWeak reference to a data-block in another library .blend file (used to re-use already appended data instead of appending new copies)\n\nType:\n\n[LibraryWeakReference](https://docs.blender.org/api/current/bpy.types.LibraryWeakReference.html#bpy.types.LibraryWeakReference), (readonly)\n\nname¶\n\nUnique data-block ID name (within a same type and library)\n\nType:\n\nstring, default “”, (never None)\n\nname_full¶\n\nUnique data-block ID name, including library one if any\n\nType:\n\nstring, default “”, (readonly, never None)\n\noriginal¶\n\nActual data-block from .blend file (Main database) that generated that evaluated one\n\nType:\n\n`ID`, (readonly)\n\noverride_library¶\n\nLibrary override data\n\nType:\n\n[IDOverrideLibrary](https://docs.blender.org/api/current/bpy.types.IDOverrideLibrary.html#bpy.types.IDOverrideLibrary), (readonly)\n\npreview¶\n\nPreview image and icon of this data-block (always None if not supported for this type of data)\n\nType:\n\n[ImagePreview](https://docs.blender.org/api/current/bpy.types.ImagePreview.html#bpy.types.ImagePreview), (readonly)\n\nsession_uid¶\n\nA session-wide unique identifier for the data block that remains the same across renames and internal reallocations, unchanged when reloading the file\n\nType:\n\nint in [-inf, inf], default 0, (readonly)\n\ntag¶\n\nTools can use this to tag data for their own purposes (initial state is undefined)\n\nType:\n\nboolean, default False\n\nuse_extra_user¶\n\nIndicates whether an extra user is set or not (mainly for internal/debug usages)\n\nType:\n\nboolean, default False\n\nuse_fake_user¶\n\nSave this data-block even if it has no users\n\nType:\n\nboolean, default False\n\nusers¶\n\nNumber of times this data-block is referenced\n\nType:\n\nint in [0, inf], default 0, (readonly)\n\nbl_system_properties_get(*, do_create=False)¶\n\nDEBUG ONLY. Internal access to runtime-defined RNA data storage, intended solely for testing and debugging purposes. Do not access it in regular scripting work, and in particular, do not assume that it contains writable data\n\nParameters:\n\ndo_create (boolean, (optional)) – Ensure that system properties are created if they do not exist yet\n\nReturns:\n\nThe system properties root container, or None if there are no system properties stored in this data yet, and its creation was not requested\n\nReturn type:\n\n[PropertyGroup](https://docs.blender.org/api/current/bpy.types.PropertyGroup.html#bpy.types.PropertyGroup)\n\nrename(name, *, mode='NEVER')¶\n\nMore refined handling in case the new name collides with another ID’s name\n\nParameters:\n\nname (string, (never None)) – New name to rename the ID to, if empty will re-use the current ID name\n\nmode (enum in [`'NEVER'`,`'ALWAYS'`,`'SAME_ROOT'`], (optional)) –\n\nHow to handle name collision, in case the requested new name is already used by another ID of the same type\n\n`NEVER` Never Rename – Never rename an existing ID whose name would conflict, the currently renamed ID will get a numeric suffix appended to its new name.\n\n`ALWAYS` Always Rename – Always rename an existing ID whose name would conflict, ensuring that the currently renamed ID will get requested name.\n\n`SAME_ROOT` Rename If Same Root – Only rename an existing ID whose name would conflict if its name root (everything besides the numerical suffix) is the same as the existing name of the currently renamed ID.\n\nReturns:\n\nHow did the renaming of the data-block went on\n\n`UNCHANGED` Unchanged – The ID was not renamed, e.g. because it is already named as requested.\n\n`UNCHANGED_COLLISION` Unchanged Due to Collision – The ID was not renamed, because requested name would have collided with another existing ID’s name, and the automatically adjusted name was the same as the current ID’s name.\n\n`RENAMED_NO_COLLISION` Renamed Without Collision – The ID was renamed as requested, without creating any name collision.\n\n`RENAMED_COLLISION_ADJUSTED` Renamed With Collision – The ID was renamed with adjustment of the requested name, to avoid a name collision.\n\n`RENAMED_COLLISION_FORCED` Renamed Enforced With Collision – The ID was renamed as requested, also renaming another ID to avoid a name collision.\n\nReturn type:\n\nenum in [`'UNCHANGED'`,`'UNCHANGED_COLLISION'`,`'RENAMED_NO_COLLISION'`,`'RENAMED_COLLISION_ADJUSTED'`,`'RENAMED_COLLISION_FORCED'`]\n\nevaluated_get(depsgraph)¶\n\nGet corresponding evaluated ID from the given dependency graph. Note that this does not ensure the dependency graph is fully evaluated, it just returns the result of the last evaluation.\n\nParameters:\n\ndepsgraph ([Depsgraph](https://docs.blender.org/api/current/bpy.types.Depsgraph.html#bpy.types.Depsgraph), (never None)) – Dependency graph to perform lookup in\n\nReturns:\n\nNew copy of the ID\n\nReturn type:\n\n`ID`\n\ncopy()¶\n\nCreate a copy of this data-block (not supported for all data-blocks). The result is added to the Blend-File Data (Main database), with all references to other data-blocks ensured to be from within the same Blend-File Data.\n\nReturns:\n\nNew copy of the ID\n\nReturn type:\n\n`ID`\n\nasset_mark()¶\n\nEnable easier reuse of the data-block through the Asset Browser, with the help of customizable metadata (like previews, descriptions and tags)\n\nasset_clear()¶\n\nDelete all asset metadata and turn the asset data-block back into a normal data-block\n\nasset_generate_preview()¶\n\nGenerate preview image (might be scheduled in a background thread)\n\noverride_create(*, remap_local_usages=False)¶\n\nCreate an overridden local copy of this linked data-block (not supported for all data-blocks)\n\nParameters:\n\nremap_local_usages (boolean, (optional)) – Whether local usages of the linked ID should be remapped to the new library override of it\n\nReturns:\n\nNew overridden local copy of the ID\n\nReturn type:\n\n`ID`\n\noverride_hierarchy_create(scene, view_layer, *, reference=None, do_fully_editable=False)¶\n\nCreate an overridden local copy of this linked data-block, and most of its dependencies when it is a Collection or and Object\n\nParameters:\n\nscene ([Scene](https://docs.blender.org/api/current/bpy.types.Scene.html#bpy.types.Scene), (never None)) – In which scene the new overrides should be instantiated\n\nview_layer ([ViewLayer](https://docs.blender.org/api/current/bpy.types.ViewLayer.html#bpy.types.ViewLayer), (never None)) – In which view layer the new overrides should be instantiated\n\nreference (`ID`, (optional)) – Another ID (usually an Object or Collection) used as a hint to decide where to instantiate the new overrides\n\ndo_fully_editable (boolean, (optional)) – Make all library overrides generated by this call fully editable by the user (none will be ‘system overrides’)\n\nReturns:\n\nNew overridden local copy of the root ID\n\nReturn type:\n\n`ID`\n\nuser_clear()¶\n\nClear the user count of a data-block so its not saved, on reload the data will be removed\n\nThis function is for advanced use only, misuse can crash Blender since the user count is used to prevent data being removed when it is used.\n\n```\n# This example shows what _not_ to do, and will crash Blender.\nimport bpy\n\n# Object which is in the scene.\nobj = bpy.data.objects[\"Cube\"]\n\n# Without this, removal would raise an error.\nobj.user_clear()\n\n# Runs without an exception but will crash on redraw.\nbpy.data.objects.remove(obj)\n\n```\n\nuser_remap(new_id)¶\n\nReplace all usage in the .blend file of this ID by new given one\n\nParameters:\n\nnew_id (`ID`, (never None)) – New ID to use\n\nmake_local(*, clear_proxy=True, clear_liboverride=False, clear_asset_data=True)¶\n\nMake this data-block local, return local one (may be a copy of the original, in case it is also indirectly used)\n\nParameters:\n\nclear_proxy (boolean, (optional)) – Deprecated, has no effect\n\nclear_liboverride (boolean, (optional)) – Remove potential library override data from the newly made local data\n\nclear_asset_data (boolean, (optional)) – Remove potential asset metadata so the newly local data-block is not treated as asset data-block and won’t show up in asset libraries\n\nReturns:\n\nThis ID, or the new ID if it was copied\n\nReturn type:\n\n`ID`\n\nuser_of_id(id)¶\n\nCount the number of times that ID uses/references given one\n\nParameters:\n\nid (`ID`, (never None)) – ID to count usages\n\nReturns:\n\nNumber of usages/references of given id by current data-block\n\nReturn type:\n\nint in [0, inf]\n\nanimation_data_create()¶\n\nCreate animation data to this ID, note that not all ID types support this\n\nReturns:\n\nNew animation data or nullptr\n\nReturn type:\n\n[AnimData](https://docs.blender.org/api/current/bpy.types.AnimData.html#bpy.types.AnimData)\n\nanimation_data_clear()¶\n\nClear animation on this ID\n\nupdate_tag(*, refresh={})¶\n\nTag the ID to update its display data, e.g. when calling`bpy.types.Scene.update`\n\nParameters:\n\nrefresh (enum set in {`'OBJECT'`,`'DATA'`,`'TIME'`}, (optional)) – Type of updates to perform\n\npreview_ensure()¶\n\nEnsure that this ID has preview data (if ID type supports it)\n\nReturns:\n\nThe existing or created preview\n\nReturn type:\n\n[ImagePreview](https://docs.blender.org/api/current/bpy.types.ImagePreview.html#bpy.types.ImagePreview)\n\nclassmethod bl_rna_get_subclass(id, default=None, /)¶ Parameters:\n\nid (str) – The RNA type identifier.\n\nReturns:\n\nThe RNA type or default when not found.\n\nReturn type:\n\n[bpy.types.Struct](https://docs.blender.org/api/current/bpy.types.Struct.html#bpy.types.Struct) subclass\n\nclassmethod bl_rna_get_subclass_py(id, default=None, /)¶ Parameters:\n\nid (str) – The RNA type identifier.\n\nReturns:\n\nThe class or default when not found.\n\nReturn type:\n\ntype\n\n## Inherited Properties¶\n\n[bpy_struct.id_data](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.id_data)\n\n## Inherited Functions¶\n\n[bpy_struct.as_pointer](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.as_pointer)\n\n[bpy_struct.driver_add](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.driver_add)\n\n[bpy_struct.driver_remove](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.driver_remove)\n\n[bpy_struct.get](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.get)\n\n[bpy_struct.id_properties_clear](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.id_properties_clear)\n\n[bpy_struct.id_properties_ensure](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.id_properties_ensure)\n\n[bpy_struct.id_properties_ui](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.id_properties_ui)\n\n[bpy_struct.is_property_hidden](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.is_property_hidden)\n\n[bpy_struct.is_property_overridable_library](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.is_property_overridable_library)\n\n[bpy_struct.is_property_readonly](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.is_property_readonly)\n\n[bpy_struct.is_property_set](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.is_property_set)\n\n[bpy_struct.items](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.items)\n\n[bpy_struct.keyframe_delete](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.keyframe_delete)\n\n[bpy_struct.keyframe_insert](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.keyframe_insert)\n\n[bpy_struct.keys](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.keys)\n\n[bpy_struct.path_from_id](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.path_from_id)\n\n[bpy_struct.path_from_module](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.path_from_module)\n\n[bpy_struct.path_resolve](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.path_resolve)\n\n[bpy_struct.pop](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.pop)\n\n[bpy_struct.property_overridable_library_set](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.property_overridable_library_set)\n\n[bpy_struct.property_unset](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.property_unset)\n\n[bpy_struct.rna_ancestors](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.rna_ancestors)\n\n[bpy_struct.type_recast](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.type_recast)\n\n[bpy_struct.values](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.values)\n\n## References¶\n\n[bpy.context.annotation_data_owner](https://docs.blender.org/api/current/bpy.context.html#bpy.context.annotation_data_owner)\n\n[bpy.context.id](https://docs.blender.org/api/current/bpy.context.html#bpy.context.id)\n\n[bpy.context.selected_ids](https://docs.blender.org/api/current/bpy.context.html#bpy.context.selected_ids)\n\n[bpy.context.texture_user](https://docs.blender.org/api/current/bpy.context.html#bpy.context.texture_user)\n\n[Action.fcurve_ensure_for_datablock](https://docs.blender.org/api/current/bpy.types.Action.html#bpy.types.Action.fcurve_ensure_for_datablock)\n\n[ActionSlot.users](https://docs.blender.org/api/current/bpy.types.ActionSlot.html#bpy.types.ActionSlot.users)\n\n[AssetRepresentation.local_id](https://docs.blender.org/api/current/bpy.types.AssetRepresentation.html#bpy.types.AssetRepresentation.local_id)\n\n[BlendData.pack_linked_ids_hierarchy](https://docs.blender.org/api/current/bpy.types.BlendData.html#bpy.types.BlendData.pack_linked_ids_hierarchy)\n\n[BlendData.pack_linked_ids_hierarchy](https://docs.blender.org/api/current/bpy.types.BlendData.html#bpy.types.BlendData.pack_linked_ids_hierarchy)\n\n[BlendDataObjects.new](https://docs.blender.org/api/current/bpy.types.BlendDataObjects.html#bpy.types.BlendDataObjects.new)\n\n[BlendImportContextItem.id](https://docs.blender.org/api/current/bpy.types.BlendImportContextItem.html#bpy.types.BlendImportContextItem.id)\n\n[BlendImportContextItem.library_override_id](https://docs.blender.org/api/current/bpy.types.BlendImportContextItem.html#bpy.types.BlendImportContextItem.library_override_id)\n\n[BlendImportContextItem.reusable_local_id](https://docs.blender.org/api/current/bpy.types.BlendImportContextItem.html#bpy.types.BlendImportContextItem.reusable_local_id)\n\n[Depsgraph.id_eval_get](https://docs.blender.org/api/current/bpy.types.Depsgraph.html#bpy.types.Depsgraph.id_eval_get)\n\n[Depsgraph.id_eval_get](https://docs.blender.org/api/current/bpy.types.Depsgraph.html#bpy.types.Depsgraph.id_eval_get)\n\n[Depsgraph.ids](https://docs.blender.org/api/current/bpy.types.Depsgraph.html#bpy.types.Depsgraph.ids)\n\n[DepsgraphUpdate.id](https://docs.blender.org/api/current/bpy.types.DepsgraphUpdate.html#bpy.types.DepsgraphUpdate.id)\n\n[DopeSheet.source](https://docs.blender.org/api/current/bpy.types.DopeSheet.html#bpy.types.DopeSheet.source)\n\n[DriverTarget.id](https://docs.blender.org/api/current/bpy.types.DriverTarget.html#bpy.types.DriverTarget.id)\n\n`ID.copy`\n\n`ID.evaluated_get`\n\n`ID.make_local`\n\n`ID.original`\n\n`ID.override_create`\n\n`ID.override_hierarchy_create`\n\n`ID.override_hierarchy_create`\n\n`ID.user_of_id`\n\n`ID.user_remap`\n\n[IDOverrideLibrary.hierarchy_root](https://docs.blender.org/api/current/bpy.types.IDOverrideLibrary.html#bpy.types.IDOverrideLibrary.hierarchy_root)\n\n[IDOverrideLibrary.reference](https://docs.blender.org/api/current/bpy.types.IDOverrideLibrary.html#bpy.types.IDOverrideLibrary.reference)\n\n[IDOverrideLibraryPropertyOperation.subitem_local_id](https://docs.blender.org/api/current/bpy.types.IDOverrideLibraryPropertyOperation.html#bpy.types.IDOverrideLibraryPropertyOperation.subitem_local_id)\n\n[IDOverrideLibraryPropertyOperation.subitem_reference_id](https://docs.blender.org/api/current/bpy.types.IDOverrideLibraryPropertyOperation.html#bpy.types.IDOverrideLibraryPropertyOperation.subitem_reference_id)\n\n[IDOverrideLibraryPropertyOperations.add](https://docs.blender.org/api/current/bpy.types.IDOverrideLibraryPropertyOperations.html#bpy.types.IDOverrideLibraryPropertyOperations.add)\n\n[IDOverrideLibraryPropertyOperations.add](https://docs.blender.org/api/current/bpy.types.IDOverrideLibraryPropertyOperations.html#bpy.types.IDOverrideLibraryPropertyOperations.add)\n\n[IDViewerPathElem.id](https://docs.blender.org/api/current/bpy.types.IDViewerPathElem.html#bpy.types.IDViewerPathElem.id)\n\n[Key.user](https://docs.blender.org/api/current/bpy.types.Key.html#bpy.types.Key.user)\n\n[KeyingSetPath.id](https://docs.blender.org/api/current/bpy.types.KeyingSetPath.html#bpy.types.KeyingSetPath.id)\n\n[KeyingSetPaths.add](https://docs.blender.org/api/current/bpy.types.KeyingSetPaths.html#bpy.types.KeyingSetPaths.add)\n\n[MaskParent.id](https://docs.blender.org/api/current/bpy.types.MaskParent.html#bpy.types.MaskParent.id)\n\n[NodeTree.get_from_context](https://docs.blender.org/api/current/bpy.types.NodeTree.html#bpy.types.NodeTree.get_from_context)\n\n[NodeTree.get_from_context](https://docs.blender.org/api/current/bpy.types.NodeTree.html#bpy.types.NodeTree.get_from_context)\n\n[NodesModifierDataBlock.id](https://docs.blender.org/api/current/bpy.types.NodesModifierDataBlock.html#bpy.types.NodesModifierDataBlock.id)\n\n[Object.data](https://docs.blender.org/api/current/bpy.types.Object.html#bpy.types.Object.data)\n\n[PropertyGroupItem.id](https://docs.blender.org/api/current/bpy.types.PropertyGroupItem.html#bpy.types.PropertyGroupItem.id)\n\n[SpaceFileBrowser.activate_asset_by_id](https://docs.blender.org/api/current/bpy.types.SpaceFileBrowser.html#bpy.types.SpaceFileBrowser.activate_asset_by_id)\n\n[SpaceNodeEditor.id](https://docs.blender.org/api/current/bpy.types.SpaceNodeEditor.html#bpy.types.SpaceNodeEditor.id)\n\n[SpaceNodeEditor.id_from](https://docs.blender.org/api/current/bpy.types.SpaceNodeEditor.html#bpy.types.SpaceNodeEditor.id_from)\n\n[SpaceProperties.pin_id](https://docs.blender.org/api/current/bpy.types.SpaceProperties.html#bpy.types.SpaceProperties.pin_id)\n\n[UILayout.template_action](https://docs.blender.org/api/current/bpy.types.UILayout.html#bpy.types.UILayout.template_action)\n\n[UILayout.template_path_builder](https://docs.blender.org/api/current/bpy.types.UILayout.html#bpy.types.UILayout.template_path_builder)\n\n[UILayout.template_preview](https://docs.blender.org/api/current/bpy.types.UILayout.html#bpy.types.UILayout.template_preview)\n\n[UILayout.template_preview](https://docs.blender.org/api/current/bpy.types.UILayout.html#bpy.types.UILayout.template_preview)"
}
```
User decision: **accepted**
Status: **completed**
---
Tool use: **web_fetch**
Parameters:
```json
{
"url": "https://docs.blender.org/api/current/bpy.types.IDOverrideLibrary.html"
}
```
Result:
```json
{
"url": "https://docs.blender.org/api/current/bpy.types.IDOverrideLibrary.html",
"markdown": "IDOverrideLibrary(bpy_struct) - Blender Python API\n\n# IDOverrideLibrary(bpy_struct)¶\n\nbase class — [bpy_struct](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct)\n\nclass bpy.types.IDOverrideLibrary(bpy_struct)¶\n\nStruct gathering all data needed by overridden linked IDs\n\nhierarchy_root¶\n\nLibrary override ID used as root of the override hierarchy this ID is a member of\n\nType:\n\n[ID](https://docs.blender.org/api/current/bpy.types.ID.html#bpy.types.ID), (readonly)\n\nis_in_hierarchy¶\n\nWhether this library override is defined as part of a library hierarchy, or as a single, isolated and autonomous override\n\nType:\n\nboolean, default True\n\nis_system_override¶\n\nWhether this library override exists only for the override hierarchy, or if it is actually editable by the user\n\nType:\n\nboolean, default False\n\nproperties¶\n\nList of overridden properties\n\nType:\n\n[IDOverrideLibraryProperties](https://docs.blender.org/api/current/bpy.types.IDOverrideLibraryProperties.html#bpy.types.IDOverrideLibraryProperties) [bpy_prop_collection](https://docs.blender.org/api/current/bpy.types.bpy_prop_collection.html#bpy.types.bpy_prop_collection) of [IDOverrideLibraryProperty](https://docs.blender.org/api/current/bpy.types.IDOverrideLibraryProperty.html#bpy.types.IDOverrideLibraryProperty), (readonly)\n\nreference¶\n\nLinked ID used as reference by this override\n\nType:\n\n[ID](https://docs.blender.org/api/current/bpy.types.ID.html#bpy.types.ID), (readonly)\n\noperations_update()¶\n\nUpdate the library override operations based on the differences between this override ID and its reference\n\nreset(*, do_hierarchy=True, set_system_override=False)¶\n\nReset this override to match again its linked reference ID\n\nParameters:\n\ndo_hierarchy (boolean, (optional)) – Also reset all the dependencies of this override to match their reference linked IDs\n\nset_system_override (boolean, (optional)) – Reset all user-editable overrides as (non-editable) system overrides\n\ndestroy(*, do_hierarchy=True)¶\n\nDelete this override ID and remap its usages to its linked reference ID instead\n\nParameters:\n\ndo_hierarchy (boolean, (optional)) – Also delete all the dependencies of this override and remap their usages to their reference linked IDs\n\nresync(scene, *, view_layer=None, residual_storage=None, do_hierarchy_enforce=False, do_whole_hierarchy=False)¶\n\nResync the data-block and its sub-hierarchy, or the whole hierarchy if requested\n\nParameters:\n\nscene ([Scene](https://docs.blender.org/api/current/bpy.types.Scene.html#bpy.types.Scene), (never None)) – The scene to operate in (for contextual things like keeping active object active, ensuring all overridden objects remain instantiated, etc.)\n\nview_layer ([ViewLayer](https://docs.blender.org/api/current/bpy.types.ViewLayer.html#bpy.types.ViewLayer), (optional)) – The view layer to operate in (same usage as the`scene` data, in case it is not provided the scene’s collection will be used instead)\n\nresidual_storage ([Collection](https://docs.blender.org/api/current/bpy.types.Collection.html#bpy.types.Collection), (optional)) – Collection where to store objects that are instantiated in any other collection anymore (garbage collection, will be created if needed and none is provided)\n\ndo_hierarchy_enforce (boolean, (optional)) – Enforce restoring the dependency hierarchy between data-blocks to match the one from the reference linked hierarchy (WARNING: if some ID pointers have been purposely overridden, these will be reset to their default value)\n\ndo_whole_hierarchy (boolean, (optional)) – Resync the whole hierarchy this data-block belongs to, not only its own sub-hierarchy\n\nReturns:\n\nSuccess, Whether the resync process was successful or not\n\nReturn type:\n\nboolean\n\nclassmethod bl_rna_get_subclass(id, default=None, /)¶ Parameters:\n\nid (str) – The RNA type identifier.\n\nReturns:\n\nThe RNA type or default when not found.\n\nReturn type:\n\n[bpy.types.Struct](https://docs.blender.org/api/current/bpy.types.Struct.html#bpy.types.Struct) subclass\n\nclassmethod bl_rna_get_subclass_py(id, default=None, /)¶ Parameters:\n\nid (str) – The RNA type identifier.\n\nReturns:\n\nThe class or default when not found.\n\nReturn type:\n\ntype\n\n## Inherited Properties¶\n\n[bpy_struct.id_data](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.id_data)\n\n## Inherited Functions¶\n\n[bpy_struct.as_pointer](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.as_pointer)\n\n[bpy_struct.driver_add](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.driver_add)\n\n[bpy_struct.driver_remove](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.driver_remove)\n\n[bpy_struct.get](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.get)\n\n[bpy_struct.id_properties_clear](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.id_properties_clear)\n\n[bpy_struct.id_properties_ensure](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.id_properties_ensure)\n\n[bpy_struct.id_properties_ui](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.id_properties_ui)\n\n[bpy_struct.is_property_hidden](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.is_property_hidden)\n\n[bpy_struct.is_property_overridable_library](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.is_property_overridable_library)\n\n[bpy_struct.is_property_readonly](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.is_property_readonly)\n\n[bpy_struct.is_property_set](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.is_property_set)\n\n[bpy_struct.items](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.items)\n\n[bpy_struct.keyframe_delete](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.keyframe_delete)\n\n[bpy_struct.keyframe_insert](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.keyframe_insert)\n\n[bpy_struct.keys](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.keys)\n\n[bpy_struct.path_from_id](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.path_from_id)\n\n[bpy_struct.path_from_module](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.path_from_module)\n\n[bpy_struct.path_resolve](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.path_resolve)\n\n[bpy_struct.pop](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.pop)\n\n[bpy_struct.property_overridable_library_set](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.property_overridable_library_set)\n\n[bpy_struct.property_unset](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.property_unset)\n\n[bpy_struct.rna_ancestors](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.rna_ancestors)\n\n[bpy_struct.type_recast](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.type_recast)\n\n[bpy_struct.values](https://docs.blender.org/api/current/bpy.types.bpy_struct.html#bpy.types.bpy_struct.values)\n\n## References¶\n\n[ID.override_library](https://docs.blender.org/api/current/bpy.types.ID.html#bpy.types.ID.override_library)"
}
```
User decision: **accepted**
Status: **completed**
---
Thought Process
So `IDOverrideLibrary` has:
- **is_system_override**: "Whether this library override exists only for the override hierarchy, or if it is actually editable by the user" - default False. So when it's True, it's NOT editable. So we need **is_system_override = False** for editable. That might be read-only - let me check. The doc says "default False" so when we create an override, maybe it's created as system override (True) and shift-click sets it to False?
Actually re-reading: "is_system_override - Whether this library override exists only for the override hierarchy, or if it is actually editable by the user". So:
- is_system_override = True → only for hierarchy, NOT editable by user
- is_system_override = False → editable by user
So after override_create(), we might need to set override_library.is_system_override = False to make it editable. Let me check if that's writable - the doc says "Type: boolean, default False" but doesn't say (readonly).
Let me read the override_create API file that was saved.
Tool use: **read_file_v2** • Read file: C:\Users\Nathan\.cursor\projects\t-Dynamic-Link-Manager\agent-tools\c2456e59-01dc-4b23-aed9-28dd8f2dc621.txt
Tool use: **ripgrep_raw_search**
Parameters:
```json
{
"pattern": "override_create|is_system_override",
"path": "T:\\Dynamic-Link-Manager",
"glob": "*.py",
"caseInsensitive": false
}
```
Additional data:
```json
{
"isPruned": true,
"pattern": "override_create|is_system_override",
"path": "T:\\Dynamic-Link-Manager",
"outputMode": "content",
"totalFiles": 2,
"totalMatches": 6,
"topFiles": [
{
"uri": "ops\\migrator.py",
"matchCount": 3
},
{
"uri": "ops/migrator.py",
"matchCount": 3
}
]
}
```
Status: **completed**
---
Thought Process
I need to find the override_create signature in that file - it was 23KB. Let me search for "override_create" in it.
Tool use: **ripgrep_raw_search**
Parameters:
```json
{
"pattern": "override_create|override_library|do_fully|remap_local",
"path": "C:\\Users\\Nathan\\.cursor\\projects\\t-Dynamic-Link-Manager\\agent-tools\\c2456e59-01dc-4b23-aed9-28dd8f2dc621.txt",
"contextBefore": 0,
"contextAfter": 8,
"caseInsensitive": false
}
```
Additional data:
```json
{
"isPruned": true,
"pattern": "override_create|override_library|do_fully|remap_local",
"path": "C:\\Users\\Nathan\\.cursor\\projects\\t-Dynamic-Link-Manager\\agent-tools\\c2456e59-01dc-4b23-aed9-28dd8f2dc621.txt",
"outputMode": "content",
"totalFiles": 1,
"totalMatches": 6,
"topFiles": [
{
"uri": "C:\\Users\\Nathan\\.cursor\\projects\\t-Dynamic-Link-Manager\\agent-tools\\c2456e59-01dc-4b23-aed9-28dd8f2dc621.txt",
"matchCount": 51
}
]
}
```
Status: **completed**
---
Thought Process
So:
- `override_create(*, remap_local_usages=False)` - no do_fully_editable parameter on the single-ID override_create.
- `override_hierarchy_create(scene, view_layer, *, reference=None, do_fully_editable=False)` - has do_fully_editable and says "Make all library overrides generated by this call fully editable by the user (none will be 'system overrides')".
So the "shift-click" in the UI toggles "system override" vs user-editable. The IDOverrideLibrary has `is_system_override` - when True it's not editable, when False it's editable. So after we call `ob.data.override_create(remap_local_usages=True)`, we might be getting a system override. We need to set `ob.data.override_library.is_system_override = False` to make it editable - if that property is writable. The API doc didn't say (readonly) for is_system_override on IDOverrideLibrary.
Let me check - the reset() method has `set_system_override=False` - so "Reset all user-editable overrides as (non-editable) system overrides". So system override = not editable. So we need is_system_override = False. I'll try setting it after override_create().
Also add debug: print before/after override_create the state of ob.data (library, override_library, and if override_library then is_system_override).
Tool use: **edit_file_v2** • Edit file: T:\Dynamic-Link-Manager\ops\migrator.py
Thought Process
Wait, the "elif" branch is wrong: I'm setting is_system_override = False when it's already False. That's a no-op. I meant: if it's already an override and is_system_override is True, set it to False. Let me fix that.
Tool use: **edit_file_v2** • Edit file: T:\Dynamic-Link-Manager\ops\migrator.py
Thought Process
Now add debug prints so the user can see what's happening: before/after override state (ob.data.library, ob.data.override_library, is_system_override). I'll add a few print lines at the start of the base-body block and after the override handling.
Tool use: **edit_file_v2** • Edit file: T:\Dynamic-Link-Manager\ops\migrator.py
Thought Process
Add one more debug print after we've done the override_create and set is_system_override, so we can see the final state.
Tool use: **edit_file_v2** • Edit file: T:\Dynamic-Link-Manager\ops\migrator.py
Thought Process
Let me double-check: in Blender's API, is `is_system_override` writable? The IDOverrideLibrary doc said "Type: boolean, default False" and did not say (readonly). So it should be writable. If it's readonly in practice we'll see from the debug. I'll leave the code as is.
Let me read the final run_step_6 to make sure it's coherent.
Tool use: **read_file_v2** • Read file: T:\Dynamic-Link-Manager\ops\migrator.py
Tool use: **read_lints**
Parameters:
```json
{
"paths": [
"T:\\Dynamic-Link-Manager\\ops\\migrator.py"
]
}
```
Result:
```json
{
"linterErrorsByFile": [
{
"relativeWorkspacePath": "T:\\Dynamic-Link-Manager\\ops\\migrator.py"
}
]
}
```
Status: **completed**
---
Thought Process
One bug: when we do `ob = ob.override_hierarchy_create(...)` we rebind `ob` to the new override object. So the rest of the loop uses that new object - good. But then we check `ob.data` - the new override object might have the same linked data still (ob.data.library could still be set). So the mesh data override block will still run. Good.
However, override_hierarchy_create with do_fully_editable=True might create overrides for the whole hierarchy including the mesh data - so ob.data might already be an override after that. Let me leave the logic as is; the debug will show what's happening.
If is_system_override is read-only in Blender, the assignment might throw. Then the user will see the exception in the console or we could catch and print. Actually we're not catching that - we only catch inside the "if getattr(ob.data, "library", None)" try block. The assignment in the "elif" branch could raise. Let me add a try/except around the is_system_override assignment so we don't break the workflow and can print if it's read-only.
Tool use: **edit_file_v2** • Edit file: T:\Dynamic-Link-Manager\ops\migrator.py
Thought Process
Done. Summary for the user.
Thought Process
The user is saying it works - the fix for making the base body library override editable (setting is_system_override = False) is working. They're referencing the terminal file. I should acknowledge and optionally suggest removing or toning down the debug prints now that it's confirmed working, unless they want to keep them for future debugging.
Thought Process
The user wants to set icons for each of the character migrator operators using Blender's built-in icons. They've specified:
- Copy attributes: copy_id
- MigNLA: nla
- CustProps: properties
- Bone Constraints: constraint_bone
- Relations: orientation_parent
- MigShapekeys: shapekey_data
In Blender add-ons, operators get icons via the `bl_icon` class attribute, and Blender uses the format like 'COPY_ID', 'NLA', etc. (uppercase with underscores). Let me find where these operators are defined - likely in ui/operators.py.
Tool use: **ripgrep_raw_search**
Parameters:
```json
{
"pattern": "bl_label.*Copy attributes|MigNLA|CustProps|Bone Constraints|Relations|MigShapekeys|migrator_copy|migrator_nla|migrator_cust|migrator_constraints|migrator_relations|migrator_basebody",
"path": "T:\\Dynamic-Link-Manager",
"glob": "*.py",
"caseInsensitive": false
}
```
Additional data:
```json
{
"isPruned": true,
"pattern": "bl_label.*Copy attributes|MigNLA|CustProps|Bone Constraints|Relations|MigShapekeys|migrator_copy|migrator_nla|migrator_cust|migrator_constraints|migrator_relations|migrator_basebody",
"path": "T:\\Dynamic-Link-Manager",
"outputMode": "content",
"totalFiles": 4,
"totalMatches": 38,
"topFiles": [
{
"uri": "ui\\panels.py",
"matchCount": 3
},
{
"uri": "ui\\operators.py",
"matchCount": 16
},
{
"uri": "ui/panels.py",
"matchCount": 3
},
{
"uri": "ui/operators.py",
"matchCount": 16
}
]
}
```
Status: **completed**
---
Thought Process
I need to see all the operator classes and add bl_icon to each. Blender icon names are typically in UPPER_SNAKE_CASE. The user gave:
- copy_id
- nla
- properties
- constraint_bone
- orientation_parent
- shapekey_data
So the Blender icon IDs are likely 'COPY_ID', 'NLA', 'PROPERTIES', 'CONSTRAINT_BONE', 'ORIENTATION_PARENT', 'SHAPEKEY_DATA'. Let me read the operators file to see the exact class definitions and add bl_icon to each.
Tool use: **read_file_v2** • Read file: T:\Dynamic-Link-Manager\ui\operators.py
Thought Process
I need to add bl_icon to each operator. In Blender's Python API, the icon is set with bl_icon and the value is the icon name in uppercase. The user specified:
- Copy attributes: copy_id → COPY_ID
- MigNLA: nla → NLA
- CustProps: properties → PROPERTIES
- Bone Constraints: constraint_bone → CONSTRAINT_BONE
- Relations: orientation_parent → ORIENTATION_PARENT
- MigShapekeys: shapekey_data → SHAPEKEY_DATA
I'll add bl_icon after bl_label (or bl_options) for each class.
Tool use: **edit_file_v2** • Edit file: T:\Dynamic-Link-Manager\ui\operators.py
Tool use: **edit_file_v2** • Edit file: T:\Dynamic-Link-Manager\ui\operators.py
Tool use: **edit_file_v2** • Edit file: T:\Dynamic-Link-Manager\ui\operators.py
Tool use: **edit_file_v2** • Edit file: T:\Dynamic-Link-Manager\ui\operators.py
Tool use: **edit_file_v2** • Edit file: T:\Dynamic-Link-Manager\ui\operators.py
Tool use: **edit_file_v2** • Edit file: T:\Dynamic-Link-Manager\ui\operators.py
Thought Process
All six operators now have bl_icon set. The panel draws these with row.operator() - the icon will show when the operator is used in a menu or if the panel uses icon_value. Let me check - in Blender, when you add bl_icon to an operator, it's used when the operator appears in menus/search. For panel layout.operator() the icon may show automatically if the UI theme supports it. I'll leave as is. No linter needed for simple string attributes.
Thought Process
The user says the icons aren't being drawn on the buttons. In Blender, when you use `row.operator("operator.id")` in a panel, it draws a button with the operator's label. The operator's `bl_icon` is used in menus and search, but for UI layout buttons you often need to pass the icon explicitly to get it to show.
Let me check how the panel draws these buttons - we need to use `row.operator(..., icon='COPY_ID')` or the icon might need to be passed differently. In Blender's UI, `layout.operator()` accepts an `icon` parameter - so we need to pass the icon when calling the operator in the panel.
Tool use: **read_file_v2** • Read file: T:\Dynamic-Link-Manager\ui\panels.py
Thought Process
The panel calls `row.operator("...", text="...")` without passing `icon=`. In Blender, when you use `layout.operator(operator_id, text=..., icon=...)`, the icon is drawn. The operator's `bl_icon` is used when the operator is invoked from a menu (Blender looks up the operator and uses its bl_icon), but when drawing in a custom panel