blender-nodes — правило для Claude Code: что делает и как установить
Правило blender-nodes для Claude Code задаёт стандарты генерации нодовых систем Blender через bpy в файлах Python. Инструкции активируются при сборке процедурных графов для Blender 5.2+.
MIT ★ 101 обновлён 2026-10-21
.github/instructions/blender-nodes.instructions.mdЧто делает blender-nodes
Правило направляет агента при написании скриптов на Python с использованием библиотеки bpy. Оно требует собирать графы нод через класс Graph из nodekit и подключать готовые библиотечные группы NK вместо ручного дублирования нод.
Стандарты запрещают обращаться к сокетам модификаторов через ID-свойства вроде mod["Socket_2"]. Вместо этого предписано вызывать функцию nodekit.inspect.set_modifier_inputs. Анимированные группы обязаны принимать параметр Time в секундах, а вариации деталей передаются в материалы через атрибуты nk_color и nk_rand.
Повторная пересборка общей группы сбрасывает её интерфейс и отвязывает связи у всех потребителей, поэтому такие группы создаются строго один раз. Готовый файл .blend проверяется запуском blender -b --factory-startup --python build.py и валидатором scripts/validate.py.
Какие задачи решает
- собирать процедурные графы нод для Blender 5.2+ через
nodekit - безопасно передавать параметры в сокеты модификаторов без ID-свойств
- организовывать входы групп в именованные панели с типами и диапазонами
- проверять сгенерированные файлы
.blendскриптомscripts/validate.py
Примеры запросов агенту
- Собери нодовый граф для процедурного материала через библиотеку NK и nodekit
- Настрой передачу времени и атрибутов nk_rand в геометрию нод
- Проверь build.py через фоновый запуск Blender и скрипт scripts/validate.py
Как установить blender-nodes
Вручную: положить файлы
.github/instructions/blender-nodes.instructions.mdПоле applyTo задаёт, к каким файлам применять
1Через маркетплейс плагинов
/plugin marketplace add gokayfem/video-to-blender/plugin install video-to-blender@video-to-blender2Вручную: положить файлы
.claude/rules/blender-nodes.mdПоле paths во frontmatter ограничивает файлы: applyTo из источника → paths
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/blender-nodes.mdcВо frontmatter: description, globs, alwaysApply. applyTo из источника → globs, иначе правило само не подключится
Вручную: положить файлы
.devin/rules/blender-nodes.mdВручную: положить файлы
.clinerules/blender-nodes.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы о blender-nodes
Как установить blender-nodes в Claude Code?
Выполните команду /plugin marketplace add gokayfem/video-to-blender, а затем /plugin install video-to-blender@video-to-blender. Также можно скопировать файл в .claude/rules/blender-nodes.md.
Что делает правило blender-nodes?
Оно определяет регламент написания процедурных графов Blender на Python, задавая работу с библиотекой nodekit, сокетами модификаторов и валидацией сцен.
Что нужно для работы blender-nodes?
Требуется Blender версии 5.2+, скилл procedural-blender-nodes, который ставится командой gh skill install gokayfem/video-to-blender procedural-blender-nodes, и тестовый скрипт scripts/validate.py.
Исходный текст
blender-nodes.instructions.md · MIT
---
applyTo: "**/*.py"
---
Copy this file into your repository's `.github/instructions/`. It applies to Python files that use `bpy` to build
Blender node systems; ignore it for other Python. For agent mode, also install the skill with
`gh skill install gokayfem/video-to-blender procedural-blender-nodes`.
- Build node trees from Python for Blender 5.2+ with nodekit's `Graph` (from the `procedural-blender-nodes` skill),
and instance the tested `NK` library groups instead of hand-writing copies.
- Give every group and input a description, inputs ranges and subtypes, put them in panels (Primary first), and
frame each block with a sentence.
- Animated groups take a `Time` input in seconds; only the top-level modifier group reads Scene Time. Per-piece
variation goes to materials through `nk_color` and `nk_rand` attributes.
- Build shared groups once; rebuilding one clears its interface and unlinks every user.
- Never set modifier inputs as ID properties (`mod["Socket_2"]`); use
`nodekit.inspect.set_modifier_inputs(mod, {"Name": value})` (`mod.properties.inputs.<identifier>.value`).
- Run Blender as `blender -b --factory-startup --python build.py`, then validate the saved .blend with
`scripts/validate.py`: zero node warnings, zero lint.
© gokayfem · MIT · gokayfem/video-to-blender