К основному содержанию
скилл CX Codex

blender-scene-setup — скилл для Claude Code: настройка сцен Blender

Скилл blender-scene-setup для Claude Code настраивает и проверяет сцены Blender. Запускается при создании проекта, уборке файла .blend и подготовке к передаче или экспорту.

MIT 558 установок ★ 2 624 обновлён 2026-11-13

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add EL4CTEO/blender-skills --skill blender-scene-setup -a claude-code
Открыть на GitHub

Что делает blender-scene-setup

Скилл проверяет единицы измерения, масштаб, имена объектов, коллекции, точки начала координат, изображения и осиротевшие данные. Для аудита запускается scripts/scene_audit.py; исправление через --fix purge scale paths допустимо только для файлов, которыми владеет команда.

Он задаёт структуру коллекций для ассета, правила именования мешей, материалов и текстур, а также настройки связывания и добавления данных из библиотек. Для экспорта коллекций описаны Collection Exporters; эта функция доступна в Blender 4.2 и новее. Масштаб сцены задаётся в метрах с Unit Scale 1.0.

Перед передачей файл очищают от осиротевших данных, а пути изображений делают относительными или упаковывают внутрь .blend. Объекты-помощники нужно исключить из экспортных коллекций: скрытия во вьюпорте недостаточно.

Какие задачи решает

  • проверить масштаб и единицы измерения сцены
  • разложить ассет по именованным коллекциям
  • переименовать объекты по правилам проекта
  • найти битые пути изображений и осиротевшие данные
  • подготовить коллекцию к экспорту или передаче

Примеры запросов агенту

  • Проверь сцену в crate.blend и перечисли проблемы аудита.
  • Разложи ассет по коллекциям и приведи имена мешей к шаблону SM_<Name>.
  • Подготовь файл Blender к передаче: проверь пути изображений и осиротевшие данные.

Как установить blender-scene-setup

1Через Skills CLI (Vercel)

npx skills add EL4CTEO/blender-skills --skill blender-scene-setup -a claude-code

2Вручную: положить файлы

~/.claude/skills/blender-scene-setup/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/blender-scene-setup/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о blender-scene-setup

Как установить blender-scene-setup в Claude Code?

Выполните npx skills add EL4CTEO/blender-skills --skill blender-scene-setup -a claude-code. Файл скилла находится по пути ~/.claude/skills/blender-scene-setup/SKILL.md.

Что делает blender-scene-setup?

Скилл проверяет и упорядочивает сцену Blender: масштаб, коллекции, имена, начала координат, библиотеки и пути к изображениям. Он также описывает подготовку данных к экспорту и передаче.

Какая версия Blender нужна для экспортёров коллекций?

Collection Exporters доступны в Blender 4.2 и новее.

Исходный текст

SKILL.md · MIT
---
name: blender-scene-setup
description: Set up and audit Blender scenes the way studios do - units and real-world scale, collection layout, naming conventions (SM_/SK_/T_/M_), origins, linking vs appending, library overrides, asset libraries and catalogs, collection exporters, orphan/path cleanup. Use when starting a project, organizing a .blend, or before handoff/export.
license: MIT
metadata:
  author: blender-agent-skills
  version: "1.2.0"
---

# Scene Setup & Hygiene

The execution model and verification steps are in `blender-core`.

## Procedure
1. Run `scripts/scene_audit.py` (add `--fix purge scale paths` only on files you own). It reports units, unapplied/negative scale, default names, objects in the scene root, missing images, orphans and far-off origins.
2. Set units: Metric, Unit Scale **1.0**, Length meters. Keep 1.0 even for Unreal/Roblox, because exporters handle the conversion (see `blender-export-pipelines`).
3. Build the collection layout (below). Every object must be in a named collection, never the scene root.
4. Name everything with the conventions below. Rename after every duplicate or join so no `.001` suffixes remain.
5. Set origins: props at the bottom-center (they sit on the ground at Z=0), characters at world origin between the feet, doors/hinges at the pivot.
6. Apply rotation and scale on meshes (Ctrl+A). Keep location unless the asset should export at the origin.
7. Re-run the audit. It's done when `issues` is empty or every remaining issue is intentional and explained.

## Collection layout (one asset per .blend, or one collection per asset)
```
ASSET_Crate
├── Crate_high      # sculpt / subdiv source (exclude from export)
├── Crate_low       # game mesh(es) SM_Crate, SM_Crate_LOD1..
├── Crate_bake      # cages, bake helpers
├── Crate_collision # UCX_SM_Crate_00 (UE) / Crate-col (Godot)
└── Crate_ref       # reference images/blockout (hide_render)
```
Use **Collection Exporters** (4.2+) to define the export once per collection, then re-export with one call:
```python
with bpy.context.temp_override(collection=col):
    bpy.ops.collection.exporter_add(name="IO_FH_gltf2")
ex = col.exporters[-1]; ex.export_properties.filepath = "//export/SM_Crate.glb"
with bpy.context.temp_override(collection=col):
    bpy.ops.collection.exporter_export(index=len(col.exporters) - 1)
```
`bpy.ops.wm.collection_export_all()` re-runs every collection exporter. 5.3: glTF exporters set the origin with `collection_center_mode` (`WORLD_ORIGIN`, `CENTER_MASS`, `OBJECT_POSITION`, `INSTANCE_OFFSET`). Collections also get one **importer** (USD only, `collection.importer_add` / `importer_import`) whose settings are saved in the .blend.

## Naming conventions (Unreal-style, accepted by all engines)
| Type | Pattern | Example |
|---|---|---|
| Static mesh | `SM_<Name>[_LOD#]` | `SM_Crate_LOD1` |
| Skeletal mesh / rig | `SK_<Name>` / `RIG_<Name>` (armature object `Armature` or `root`) | `SK_Hero` |
| Material | `M_<Name>` / instance `MI_<Name>` | `M_Wood_Oak` |
| Texture | `T_<Name>_<Suffix>`: `_BC` base color, `_N` normal, `_ORM` (R=AO G=Rough B=Metal), `_E` emissive, `_M` mask | `T_Crate_ORM` |
| Collision | UE `UCX_<Mesh>_##`, Godot suffix `-col`/`-colonly`/`-convcolonly` | `UCX_SM_Crate_00` |
| Bones/sides | `.L`/`.R` suffix (Blender mirror tools depend on it) | `upper_arm.L` |
| Actions | `<Rig>_<Clip>` | `Hero_Run` |
Use ASCII only, no spaces, and PascalCase or snake_case consistently across the project.

## Real-world scale reference (meters)
Door 2.0–2.1 × 0.9 · ceiling 2.4–2.7 · table 0.75 · chair seat 0.45 · counter 0.9 · stair rise 0.18 / tread 0.28 · adult human 1.7–1.8 (eyes 1.6) · car 4.5 × 1.8 × 1.5. Roblox: 1 stud ≈ 0.28 m; default character ≈ 5 studs tall. Wrong scale breaks physics, lighting falloff, DOF and texel density, so check `ob.dimensions` first.

## Linking, appending, overrides
- **Append** (`libraries.load(link=False)`) makes a local copy. Use it for one-off reuse.
- **Link** (`link=True`) is read-only, updates from the source and is what pipelines use. To edit a linked collection, add a library override: `ob.override_hierarchy_create(scene, view_layer, do_fully_editable=False)`. Only overridable properties (transforms, pose, and anything marked overridable) can change.
- Keep library paths relative (`//`). Check `bpy.data.libraries` for broken paths.

## Asset libraries
- Mark: `ob.asset_mark(); ob.asset_generate_preview()`. Metadata goes in `ob.asset_data` (`author`, `description`, `license`, `tags.new("wood")`, `catalog_id`).
- Catalogs live in `blender_assets.cats.txt` at the library root, one line per catalog: `UUID:Path/Sub:Simple Name`.
- Register a library with `prefs.filepaths.asset_libraries.new(name=..., directory=...)`. 5.2+: remote libraries via `use_remote_url` + `remote_url`. In 5.2 `active_asset_library` indices are offset by 2 ("All", "Essentials").
- Import method per library: `LINK`, `APPEND`, `APPEND_REUSE` (default; reuses already-appended data).

## Hygiene rules
- Purge orphans before shipping (`bpy.data.orphans_purge(do_recursive=True)`). Use fake users only on purpose.
- Image paths: relative (`file.make_paths_relative`), or pack for single-file delivery (`file.pack_all`).
- Never ship multi-user mesh data that has an unapplied per-object scale. Instances are fine, but bake scale before export.
- Hide helpers with `hide_render=True` **and** exclude them from export collections; viewport hiding alone isn't enough.
- One active scene per file for delivery. Extra scenes confuse exporters (`use_active_scene`).

© blender-agent-skills · MIT · EL4CTEO/blender-skills

Похожие скиллы

Все скиллы по теме «Геймдев и 3D: Unity, Unreal, Godot, Blender» →
blender-motion-state-inspection affaan-m Скилл blender-motion-state-inspection для Claude Code извлекает параметры скелета, костей и контактов в Blender. Проверяет скольжение ног, проваливание в пол и инверсию осей ретаргетинга. CX Codex +1 7 000установок blender-web-pipeline freshtechbro Скилл blender-web-pipeline настраивает экспорт 3D-моделей из Blender в веб-формат glTF 2.0. Он помогает автоматизировать сжатие геометрии, запекание текстур и пакетную обработку сцен. CX Codex +1 4 100установок blender-modeling RobLe3 Скилл blender-modeling для ИИ-агента: создаёт и правит 3D-меши в Blender по текстовому запросу — примитивы, модификаторы, bmesh-правки. CX Codex +1 4 100установок blender-materials RobLe3 Скилл blender-materials для Claude Code: создаёт и назначает PBR-материалы в Blender через Principled BSDF — металл, стекло, пластик, ткань, кожу. Выполняет запросы «как медь» или «матовую поверхность». CX Codex +1 3 100установок Blender SFKislev Скилл Blender для Claude Code управляет открытой сценой Blender через локальный мост Flue. Агент читает объекты и материалы, а также выполняет небольшие скрипты bpy по запросу. CX Codex +1 2 900установок blender-mcp vladmdgolam Учит работать с Blender через MCP: инспектировать сцену, писать bpy-скрипты, экспортировать в GLB. Подключается при первом же вызове get_scene_info или execute_python. CX Codex +1 2 700установок

Из того же набора28

Весь набор →
blender-retopology-uv Скилл blender-retopology-uv для Claude Code помогает переделать скульпт или скан в игровую сетку и подготовить UV для текстурирования и запекания. Включается при работе с ретопологией и развёрткой в Blender 5.3. CX Codex +1 603установок blender-texture-baking Скилл blender-texture-baking для Claude Code автоматизирует запекание карт нормалей, AO и PBR-текстур в Blender 5.3 через движок Cycles. Включается при переносе деталей со скульптов или конвертации процедурных материалов. CX Codex +1 587установок blender-rendering Скилл blender-rendering для Claude Code настраивает рендеринг в Blender 5.3 для кадров, анимаций и turntable. Включается для рендера кадра, анимации или turntable. CX Codex +1 582установок blender-geometry-nodes Скилл blender-geometry-nodes для Claude Code помогает собирать Geometry Nodes в Blender. Он включается при создании процедурных объектов, рассеивании экземпляров и настройке входов модификатора. CX Codex +1 563установок blender-sculpting Скилл blender-sculpting для Claude Code управляет процедурным скульптингом в Blender 5.3 для персонажей и органических форм. Включается при создании базовых сетк, проработке деталей и подготовке запекания. CX Codex +1 558установок blender-facial-shapekeys Скилл blender-facial-shapekeys для Claude Code настраивает лицевые риги и шейп-кеи в Blender 5.3 для ARKit 52 и экспорта в движки. Запускается при подготовке трехмерных персонажей к анимации или экспорту. CX Codex +1 548установок blender-workflow-recipes Скилл blender-workflow-recipes для Claude Code и Cursor собирает пайплайны для Blender 5.3 с этапами контроля качества и обработки моделей. Запускается на каждый запрос по многостадийной обработке активов. CX Codex +1 543установок blender-pipeline-automation Скилл blender-pipeline-automation для Claude Code автоматизирует пакетную обработку файлов Blender и работу с библиотеками. Он запускает конвертацию, инвентаризацию и пользовательские скрипты для папок с 3D-файлами. CX Codex +1 509установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой