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

blender-pbr-materials — скилл для Claude Code

Скилл blender-pbr-materials для Claude Code настраивает PBR-материалы и текстурные карты для Blender 5.3 по правилам игровых движков.

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

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

Что делает blender-pbr-materials

Скилл задаёт стандарты для физически корректных материалов в Blender 5.3, охватывая параметры Principled BSDF, упаковку каналов в ORM, цветовые пространства sRGB и Non-Color, а также нормали для DirectX и OpenGL. Сценарий scripts/build_pbr_material.py автоматически собирает текстурный набор по имени файлов, настраивает каналы и привязывает карты к объекту. Для работы скрипта требуется Python-окружение в Blender и корректные пути к текстурам.

Инструмент настраивает альфа-режимы, смещение высоты и перенос процедурных нод в текстуры через запекание. Поддерживаются разные движки вроде Unity, Unreal Engine, Godot и Roblox, а также выбор просмотровых трансформаций AgX и Khronos PBR Neutral. Правильное распределение слотов помогает избежать типичного «компьютерного» вида рендеров и ошибок экспорта.

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

  • собрать PBR-материал из набора текстур через скрипт
  • настроить цветовые пространства для карт шероховатости и металличности
  • упаковать карты в ORM-формат для веб-экспорта и glTF
  • конвертировать нормали из формата DirectX в OpenGL
  • применить правильный метод прозрачности для листвы и стекла

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

  • Собери PBR-материал для ящика из текстур в папке //tex/crate на объекте SM_Crate
  • Настрой правильные цветовые пространства для карт шероховатости и нормалей в Blender
  • Подготовь ORM-упаковку текстур для экспорта в glTF

Как установить blender-pbr-materials

1Через Skills CLI (Vercel)

npx skills add EL4CTEO/blender-skills --skill blender-pbr-materials -a claude-code

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

~/.claude/skills/blender-pbr-materials/SKILL.md

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

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

Вопросы о blender-pbr-materials

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

Выполните команды npx skills add EL4CTEO/blender-skills --skill blender-pbr-materials -a claude-code и затем обратитесь к файлу ~/.claude/skills/blender-pbr-materials/SKILL.md.

Что делает blender-pbr-materials?

Скилл автоматизирует настройку PBR-материалов, текстурных связей, цветовых пространств и параметров экспорта для игровых движков в Blender 5.3.

Что нужно для работы blender-pbr-materials?

Для работы со скриптами сборки материалов требуется установленный Blender 5.3 и настроенная среда Python для выполнения утилит из репозитория.

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

SKILL.md · MIT
---
name: blender-pbr-materials
description: Physically based materials in Blender 5.3 - metal/roughness rules, Principled BSDF inputs, color spaces (sRGB vs Non-Color), measured albedo/F0 values, texture-set auto-wiring, ORM channel packing, DirectX vs OpenGL normals, alpha modes, displacement, view transforms (AgX, Khronos PBR Neutral), engine-ready material rules. Use when creating, fixing, or exporting materials and textures.
license: MIT
metadata:
  author: blender-agent-skills
  version: "1.2.0"
---

# PBR Materials

The execution model is in `blender-core`. Measured values are in [references/pbr-values.md](references/pbr-values.md).

## Fast paths
- Texture set → material: `scripts/build_pbr_material.py -- --name M_Crate --textures //tex/crate --objects SM_Crate`. It detects maps by filename (Poly Haven, ambientCG, Substance, UE suffixes), sets color spaces, splits ORM, flips DirectX normals, and routes AO to glTF.
- Solid physically-plausible material: `--preset gold|iron|plastic|rubber|wood|glass|skin|...` with an optional `--color R G B` (sRGB).

## The rules (violations are what make renders look "CG")
1. **Metallic is binary**: 0 (dielectric) or 1 (raw metal). Use in-between values only on transition pixels (dust or rust edges on metal). Painted metal counts as dielectric.
2. **Base color = albedo with no lighting**: no baked shadows/AO/highlights. Dielectric range is sRGB ~30–240 (linear 0.012–0.87): charcoal ≈ 50, fresh snow ≈ 240. Metals: base color = F0 reflectance, sRGB 180–255, never dark.
3. **Roughness carries the realism**. Break it up with grunge, smudges and wear. A constant roughness value looks fake; vary it ±0.1–0.2 across a surface.
4. **Color spaces**: Base Color and Emission use `sRGB`. Roughness, Metallic, Normal, AO, Height, Opacity and ORM use `Non-Color`. A wrong color space is the #1 bug (washed-out normals, wrong roughness).
5. **Specular**: leave `IOR` 1.5 and `Specular IOR Level` 0.5 for almost all dielectrics. Change IOR only for known materials (water 1.33, glass 1.5, diamond 2.42).
6. **Normal maps**: Blender, glTF, Unity and Roblox use **OpenGL** (Y+). Unreal and Substance's DirectX preset use **DirectX** (Y-), so flip G when converting. The bake and the target must use the same tangent basis (MikkTSpace) and the same triangulation.
7. **AO**: the Principled BSDF has no AO input. For engines, ship AO in the ORM red channel. For Cycles renders, don't multiply AO into base color, because the renderer computes occlusion.

## Principled BSDF (5.2) quick map
`Base Color`, `Metallic`, `Roughness`, `IOR`, `Alpha`, `Normal`, `Thin Wall` (5.2: leaves/paper/fabric sheets without volume), `Subsurface Weight/Radius/Scale` (skin, wax; Scale in meters ≈ 0.005–0.02 for skin), `Specular IOR Level`, `Specular Tint`, `Anisotropic`, `Transmission Weight` (glass/liquids), `Coat Weight/Roughness/Normal` (car paint, varnish), `Sheen Weight` (cloth, velvet), `Emission Color/Strength` (strength in W/m²-ish units; 1–10 for screens, 50+ for bulbs), `Thin Film Thickness/IOR` (soap, oil, coated lenses), `Diffuse Roughness`, `Transmission Dispersion Scale/Abbe Number` (5.3: gems, prisms; Abbe ≈ 64 crown glass, 55 diamond, 30–40 flint glass; lower = more color fringing). 5.3 transmission also follows `Anisotropic`.

## Engine export rules
| Target | Maps | Packing | Normal |
|---|---|---|---|
| glTF / web / Godot | baseColor(+alpha), metallicRoughness, normal, occlusion, emissive | glTF: **R=AO G=Rough B=Metal** (ORM) | OpenGL |
| Unreal | BaseColor, Normal, ORM | R=AO G=Rough B=Metal | DirectX (UE flips on import if the texture is marked) |
| Unity URP/HDRP | BaseMap, Normal, MetallicSmoothness / HDRP MaskMap | URP: R=Metal A=**Smoothness** (1-rough). HDRP Mask: R=Metal G=AO B=DetailMask A=Smoothness | OpenGL |
| Roblox SurfaceAppearance | ColorMap(+alpha), NormalMap, MetalnessMap, RoughnessMap, EmissiveMaskContent | separate grayscale maps, no packing | OpenGL, tangent space |
- Only image-texture → BSDF chains export. Procedural nodes, Mix nodes and math become nothing in engines, so bake them first (`blender-texture-baking`).
- One material per texture set. Every extra material is an extra draw call (`blender-game-optimization`).
- Power-of-two textures (512/1024/2048/4096). Use PNG/TGA for data maps, never JPEG for normals.

## Alpha
`mat.surface_render_method = "DITHERED"` (cutout/alpha-clip, sorts correctly, good for foliage/hair cards) or `"BLENDED"` (true transparency, glass/UI). Connect `Alpha`. glTF exports CLIP/BLEND from the alpha setup. Prefer dithered/clip for games.

## Displacement
Height map → `Displacement` node → Material Output `Displacement`. `mat.displacement_method`: `BUMP` (shading only, everywhere), `BOTH`/`DISPLACEMENT` (Cycles, needs dense or adaptively subdivided geometry: Subdivision modifier `use_adaptive_subdivision`). Scale is in meters; midlevel 0.5 for 8-bit, 0 for 32-bit EXR.

## View transform (judge materials under the right one)
`scene.view_settings.view_transform`: **AgX** (default, photographic), **Khronos PBR Neutral** (what-you-see-is-the-albedo; use for asset/product review and glTF parity), **Standard** (UI/graphics/textures that must match pixels), ACES 1.3/2.0 (VFX pipelines). Never bake or author textures while looking through Filmic/AgX with an extreme "Look".

## Procedural → texture
Procedural setups (noise/voronoi wear, curvature masks via `Geometry > Pointiness` (Cycles) or `Ambient Occlusion` node, edge wear via `Bevel` node normals) are fine for renders. For engines, bake them to the texture set (`blender-texture-baking`). Node Wrangler (bundled) `Ctrl+Shift+T` does the same as `build_pbr_material.py`, but needs the UI.

## Gotchas
- `material.use_nodes` is deprecated in 5.x. New materials already have Principled + Output.
- `mat.diffuse_color` only affects the viewport (Solid mode/workbench), not renders or export.
- Images loaded headless need `image.colorspace_settings.name` set **before** baking or export.
- Shared texture images used by several materials: change the color space once, because it's per image.

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

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

Все скиллы по теме «Геймдев и 3D: Unity, Unreal, Godot, Blender» →
blender-materials RobLe3 Скилл blender-materials для Claude Code: создаёт и назначает PBR-материалы в Blender через Principled BSDF — металл, стекло, пластик, ткань, кожу. Выполняет запросы «как медь» или «матовую поверхность». CX Codex +1 3 100установок materials https://github.com/arjun988 Скилл materials для Claude Code автоматизирует создание PBR и стилизованных материалов в Blender через MCP. Используется при разработке шейдеров, настройке внешнего вида объектов и подготовке сцен к рендерингу. CX Codex +1 708установок scenario-blender-expert scenario-labs Скилл scenario-blender-expert для Claude Code помогает автоматизировать Blender через Python и MCP: моделировать, запекать, настраивать риг и проверять меши перед экспортом. CX Codex +1 1 700установок scenario-blender-texturing-shading scenario-labs Скилл scenario-blender-texturing-shading для текстурирования и look-dev в Blender: собирает PBR-материалы из текстурных наборов, рисует маски и грязь, разбирается с цветовыми пространствами. CX Codex +1 1 100установок blender-image-to-3d majidmanzarpour Скилл blender-image-to-3d для Claude Code собирает игровой 3D-ассет в Blender по референсам через контролируемые фазы с рендером и сравнением. Запускается при упоминании референс-изображения для создания модели. CX Codex +1 917установок texture-workflow https://github.com/arjun988 Скилл texture-workflow для Claude Code координирует запекание PBR-карт, сборку атласов и упаковку текстур в Blender через MCP. Управляет переносом деталей со скульпта на оптимизированные игровые модели. CX Codex +1 667установок

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

Весь набор →
blender-asset-qa Скилл blender-asset-qa для Claude Code автоматизирует проверку 3D-моделей и ассетов в Blender. Запускается перед экспортом или сдачей задачи. CX Codex +1 765установок blender-animation Скилл blender-animation для Claude Code, автоматизирующий анимацию в Blender 5.3 через Python-скрипты. Управляет ключевыми кадрами, ретаргетингом mocap и запеканием ригов для игровых движков. CX Codex +1 757установок blender-export-pipelines Скилл blender-export-pipelines для Claude Code настраивает экспорт ассетов из Blender под игровые движки и другие форматы. Включается, когда ассет нужно выгрузить из Blender и проверить результат. CX Codex +1 681установок blender-game-optimization Скилл blender-game-optimization работает в Claude Code, Codex, Cursor и других платформах для оптимизации трехмерных моделей под лимиты игровых движков. CX Codex +1 657установок blender-hardsurface-modeling Скилл blender-hardsurface-modeling для Claude Code задаёт пайплайн hard-surface моделирования в Blender 5.3: от блокаута до сборки стека модификаторов. Помогает моделировать технику, оружие и пропсы. CX Codex +1 621установок blender-lighting-lookdev Скилл blender-lighting-lookdev для Claude Code настраивает свет, камеры и вид материалов в Blender 5.3. Подключается при подготовке сцены к рендеру или презентации ассета. CX Codex +1 606установок 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установок

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

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