Skip to main content
skill CX Codex

blender-pbr-materials — Claude Code skill: what it does

blender-pbr-materials — a skill for Claude Code configures PBR materials and texture sets in Blender 5.3 following engine-ready rules.

MIT 644 installs ★ 2,624 updated 2026-11-13

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add EL4CTEO/blender-skills --skill blender-pbr-materials -a claude-code
Open on GitHub

What blender-pbr-materials does

The skill enforces physically based material rules for Blender 5.3, covering Principled BSDF inputs, ORM channel packing, sRGB versus Non-Color spaces, and DirectX or OpenGL normal maps. The scripts/build_pbr_material.py script automates texture set assembly by filename, configures color spaces, and wires maps directly to target objects. Running the build scripts requires a functioning Python environment inside Blender.

The rules cover alpha modes, displacement, view transforms like AgX and Khronos PBR Neutral, and procedural baking for engines such as Unity, Unreal Engine, Godot, and Roblox. Proper setup prevents washed-out normals, incorrect roughness values, and common rendering artifacts.

What it helps with

  • assemble a PBR material from texture files via script
  • configure correct color spaces for roughness and normal maps
  • pack occlusion, roughness, and metalness into an ORM texture
  • convert normal maps between DirectX and OpenGL formats
  • set up dithered or blended alpha modes for foliage and glass

Example prompts for the agent

  • Build a PBR material for crate textures in //tex/crate applied to SM_Crate
  • Configure the correct color spaces for roughness and normal maps in Blender
  • Prepare ORM texture packing for glTF export

How to install blender-pbr-materials

1Skills CLI (Vercel)

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

2Manually: put the files in place

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

Copy the whole skill folder; for one project use .claude/skills/blender-pbr-materials/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about blender-pbr-materials

How to install blender-pbr-materials in Claude Code?

Run npx skills add EL4CTEO/blender-skills --skill blender-pbr-materials -a claude-code followed by ~/.claude/skills/blender-pbr-materials/SKILL.md.

What does blender-pbr-materials do?

It provides rules and automation scripts for setting up physically based materials, texture channels, and engine-ready exports in Blender 5.3.

What is required to run blender-pbr-materials?

Blender 5.3 and a Python environment capable of executing the repository's helper scripts are required for automated material building.

Source text

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

Similar skills

All skills for Game dev and 3D: Unity, Unreal, Godot, Blender →
blender-materials RobLe3 blender-materials is a Claude Code skill that creates and assigns PBR materials in Blender via Principled BSDF for requests such as “make it look like copper” or “matte finish”. CX Codex +1 3,100installs materials https://github.com/arjun988 The materials skill automates PBR and stylized material creation in Blender via MCP. It is triggered during look development, procedural shader design, and production asset preparation. CX Codex +1 708installs scenario-blender-expert scenario-labs scenario-blender-expert is a Claude Code skill for Blender automation via Python and MCP, covering mesh audits, rigging, rendering, and Blender 5.x compatibility. CX Codex +1 1,700installs scenario-blender-texturing-shading scenario-labs scenario-blender-texturing-shading — a skill for texturing and look-dev in Blender: builds PBR materials from texture sets, drives wear and grime through masks, and sorts out color spaces. CX Codex +1 1,100installs blender-image-to-3d majidmanzarpour The blender-image-to-3d skill builds a game-ready 3D asset in Blender from reference images through gated phases with renders. Runs whenever a user supplies a reference image for modeling. CX Codex +1 917installs texture-workflow https://github.com/arjun988 texture-workflow — a skill for Claude Code that orchestrates PBR map baking, atlas packing, and texture memory optimization in Blender via MCP. Executes during low-poly asset preparation for game engines. CX Codex +1 667installs

From the same set28

The whole set →
blender-asset-qa blender-asset-qa — a Claude Code skill for automated review of meshes and assets in Blender. Runs before export or delivery. CX Codex +1 765installs blender-animation blender-animation — a skill for Claude Code that automates Blender 5.3 animation via Python scripts. It handles keyframing, mocap retargeting, and rigging bake processes for game engines. CX Codex +1 757installs blender-export-pipelines The blender-export-pipelines Claude Code skill exports Blender assets with presets for game engines and other formats. It activates when an asset needs to leave Blender and the exported file needs checking. CX Codex +1 681installs blender-game-optimization The blender-game-optimization skill runs in Claude Code, Codex, Cursor and other platforms to optimize Blender 3D assets for real-time engine limits. CX Codex +1 657installs blender-hardsurface-modeling blender-hardsurface-modeling — a skill for Claude Code guides hard-surface and prop modeling workflows in Blender 5.3. Sets up blockout rules, modifier pipelines, and topology checks. CX Codex +1 621installs blender-lighting-lookdev The blender-lighting-lookdev Claude Code skill sets up lighting, cameras and material look-dev in Blender 5.3. It activates for render scenes, asset presentations and consistent material checks. CX Codex +1 606installs blender-retopology-uv The blender-retopology-uv Claude Code skill covers retopology and UV work in Blender 5.3. Use it to turn a sculpt or scan into a game mesh, or prepare UVs for texturing and baking. CX Codex +1 603installs blender-texture-baking blender-texture-baking — a skill for Claude Code that runs Cycles baking pipelines in Blender 5.3. Triggers when transferring high-poly sculpt details to game assets or converting procedural node networks to images. CX Codex +1 587installs

Project sponsors

Companies that keep this analytics open