procedural-blender-nodes — правило для Claude Code
Правило procedural-blender-nodes для Claude Code помогает автоматизировать создание и редактирование узлов в Blender через скрипты bpy. Оно настраивает агента на корректную работу с процедурными генераторами и графами Blender 5.x.
MIT ★ 101 обновлён 2026-10-21
.cursor/rules/procedural-blender-nodes.mdcЧто делает procedural-blender-nodes
Это правило направляет ИИ при написании Python-скриптов, работающих с Geometry Nodes, Shader Nodes и композитором. Инструмент отслеживает структуру графов, использование библиотек групп NK и передачу параметров анимации через входы времени. При работе с Blender 5.2 правило предотвращает прямую модификацию сокетов, предлагая использовать специальные методы проверки модификаторов.
Для работы требуется наличие Blender в системе и установленные bpy скрипты. Агент использует правило для валидации узловых сетей: после сборки проекта build.py рекомендуется запускать scripts/validate.py для контроля отсутствия предупреждений в .blend файлах. Файл конфигурации помещается в директорию .claude/rules/ или аналогичные папки инструментов, чтобы агент мог обращаться к правилам построения при создании геометрии.
Какие задачи решает
- Автоматическая генерация процедурных сетей узлов
- Валидация корректности структуры Blender-графов
- Портирование скриптов под архитектуру Blender 5.x
- Управление входными данными для анимированных групп
Примеры запросов агенту
- Сгенерируй скрипт
build.pyдля процедурного генератора ландшафта, используяprocedural-blender-nodes. - Проверь текущий узел на соответствие правилам Blender 5.2 с помощью
scripts/validate.py. - Обнови входы модификатора согласно
nodekit.inspect.set_modifier_inputs.
Как установить procedural-blender-nodes
Вручную: положить файлы
.cursor/rules/procedural-blender-nodes.mdcВо frontmatter: description, globs, alwaysApply
1Через маркетплейс плагинов
/plugin marketplace add gokayfem/video-to-blender/plugin install video-to-blender@video-to-blender2Вручную: положить файлы
.claude/rules/procedural-blender-nodes.mdПоле paths во frontmatter ограничивает файлы: globs из источника → paths
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.github/instructions/procedural-blender-nodes.instructions.mdПоле applyTo задаёт, к каким файлам применять: globs из источника → applyTo
Вручную: положить файлы
.devin/rules/procedural-blender-nodes.mdВручную: положить файлы
.clinerules/procedural-blender-nodes.mdПо шагам, с командами для каждой платформы: Cursor rules: файлы .mdc, четыре режима и замена .cursorrules
Вопросы о procedural-blender-nodes
Как установить procedural-blender-nodes в Claude Code?
Выполните /plugin marketplace add gokayfem/video-to-blender, затем /plugin install video-to-blender@video-to-blender и разместите правило в .claude/rules/procedural-blender-nodes.md.
Что делает procedural-blender-nodes?
Правило задаёт стандарты для написания bpy кода: как группировать узлы, именовать входы и управлять динамическими параметрами в процедурных сценах.
Что нужно для работы procedural-blender-nodes?
Для работы необходим установленный Blender и Python-среда с библиотекой bpy для выполнения скриптов сборки и валидации.
Исходный текст
procedural-blender-nodes.mdc · MIT
---
description: Blender bpy scripts that build or edit node trees (Geometry Nodes, Shader Nodes, compositor), procedural generators, Blender 5.x ports
globs: **/*.py
alwaysApply: false
---
Copy this file into your project's `.cursor/rules/`. It applies to Python files that use `bpy` to build node systems;
ignore it for other Python. Install the skill too (Cursor reads `~/.cursor/skills`, `~/.claude/skills` and
`.agents/skills`), so the rule can point at it.
- Use the `procedural-blender-nodes` skill: route the subject with `references/subject-routing.md`, find groups with
`scripts/nodes_tools.py search`, build every group with nodekit's `Graph`, and instance `NK` library groups
instead of rewriting them.
- Every group and input has a description; inputs have ranges and subtypes and sit in panels (a Primary panel first);
each block is in a labelled frame.
- Animated groups take a `Time` input in seconds; only the top-level modifier group reads Scene Time.
- Per-piece variation reaches materials as `nk_color` (FLOAT_COLOR) and `nk_rand` (FLOAT 0..1) attributes.
- Shared groups are built once (`@nodegroup` or `nodekit.graph.once`); rebuilding one unlinks its users.
- Blender 5.2: never `mod["Socket_N"]`; use `nodekit.inspect.set_modifier_inputs(mod, {"Name": value})`. Modes on
Transform, Resample and Set Curve Normal are input sockets.
- Run Blender as `blender -b --factory-startup --python build.py`, then `scripts/validate.py` on the saved .blend;
zero node warnings, zero lint.
© gokayfem · MIT · gokayfem/video-to-blender