# godot-3d-materials

This skill guides Godot PBR material setup and points to scripts for textures, transparency, and visual effects. Use it while building 3D surfaces or tuning material workflows.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 424 installs · ★ 897
- Author: thedivergentai
- License: LGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/thedivergentai/Game-Dev-Agentic-Skills/tree/HEAD/skills/godot-3d-materials/SKILL.md
- Updated: 2026-10-16
- HTML: https://affpapa.org/en/nevibecode/skills/godot-3d-materials

## What it does

The skill covers `StandardMaterial3D` settings for albedo, metallic and roughness values, normal maps, ORM textures, and transparency. Its scripts include an ORM packer for AO, Roughness, and Metallic, a transparency sorting fix, and tools for batching materials.

For meshes without UVs, it includes triplanar projection shaders. Other files handle foliage wind, subsurface scattering, and decals. The task determines which files to load; ordinary PBR work does not call for the wind or triplanar shaders. Runtime effects need special care: `material_fx.gd` provides helpers to make a separate material instance before changing it, rather than modifying a shared `.tres` resource.

## Requirements
- Works with: Godot

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-3d-materials -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/godot-3d-materials/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/godot-3d-materials/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-3d-materials -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/godot-3d-materials/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-3d-materials -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/godot-3d-materials/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install thedivergentai/Game-Dev-Agentic-Skills godot-3d-materials
```

2. **Manually: put the files in place**
- File: `.github/skills/godot-3d-materials/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-3d-materials -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/thedivergentai/Game-Dev-Agentic-Skills --path skills/godot-3d-materials
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/godot-3d-materials/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-3d-materials -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/thedivergentai/Game-Dev-Agentic-Skills/tree/HEAD/skills/godot-3d-materials/SKILL.md

## When to use it
- pack AO, Roughness, and Metallic into an ORM texture
- set up transparency without full alpha blending
- build a triplanar material for a mesh with no UVs
- animate foliage with vertex-driven wind
- change a material at runtime without editing a shared resource

## Example prompts
- Set up a Godot PBR material for a metal surface and choose an ORM texture workflow.
- Build a triplanar material for a rock mesh with no UV mapping.
- Add a runtime dissolve effect without changing the shared `.tres` material.

## Similar
- [orbit-card](https://affpapa.org/en/nevibecode/skills/orbit-card.md) — skill · 10000 installs
- [cad](https://affpapa.org/en/nevibecode/skills/cad.md) — skill · 14000 installs
- [step-parts](https://affpapa.org/en/nevibecode/skills/step-parts.md) — skill · 11200 installs
- [sdf](https://affpapa.org/en/nevibecode/skills/sdf.md) — skill · 10500 installs
- [urdf](https://affpapa.org/en/nevibecode/skills/urdf.md) — skill · 10500 installs
- [hatch-pet](https://affpapa.org/en/nevibecode/skills/hatch-pet.md) — skill · 3300 installs

From the same set: [thedivergentai/game-dev-agentic-skills](https://affpapa.org/en/nevibecode/by/thedivergentai/game-dev-agentic-skills.md) — 61 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
