# unreal-export

unreal-export — a skill for Claude Code that handles Blender-to-Unreal Engine asset export, configuring FBX scale, UCX collision, and LODs.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 533 installs · ★ 4589 repo stars
- Author: https://github.com/arjun988
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/arjun988/blender-skills/tree/HEAD/.claude/skills/unreal-export/SKILL.md
- Updated: 2026-11-06
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/unreal-export

## What it does

The agent runs this skill when handling exports of static and skeletal meshes, collision setups, and socket hierarchies from Blender into Unreal Engine. It enforces centimeter scale awareness, applies correct axis orientations, and formats names for meshes and collision proxies. The pipeline verifies pivots and checks transforms against engine requirements.

Naming patterns strictly follow engine standards, such as `SM_Name` for static geometry and `UCX_SM_Name_01` for physics colliders. Dimensions must be verified against a known reference unit after import.

## Requirements
- Works with: Unreal Engine, Blender

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add arjun988/blender-skills --skill unreal-export -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add arjun988/blender-skills --skill unreal-export -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add arjun988/blender-skills --skill unreal-export -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install arjun988/blender-skills .claude/skills/unreal-export
```

2. **Manually: put the files in place**
- File: `.github/skills/unreal-export/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add arjun988/blender-skills --skill unreal-export -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/arjun988/blender-skills --path .claude/skills/unreal-export
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add arjun988/blender-skills --skill unreal-export -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/arjun988/blender-skills/tree/HEAD/.claude/skills/unreal-export/SKILL.md

## When to use it
- export FBX models with correct Unreal Engine scale
- set up UCX collision meshes for physics actors
- configure LOD chains and socket empties
- prepare skeletal meshes without leftover Blender deform data

## Example prompts
- Export this mesh from Blender for Unreal
- Set up UCX collision and LODs for the model
- Configure FBX export settings and scale

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: cc6c1c237fe65049.

BEGIN THIRD-PARTY FILE cc6c1c237fe65049
````text
---
name: unreal-export
description: Unreal Engine-specific Blender export for FBX scale, LODs, UCX collision, sockets, materials, and skeletal mesh workflows via MCP.
license: MIT
metadata:
  author: https://github.com/arjun988
  version: "1.0.0"
  domain: blender
  role: specialist
  triggers: Unreal, UE5, UE4, Unreal export, UCX, Unreal LOD, skeletal mesh, Unreal FBX, socket
  related-skills: export-pipeline, lod-pipeline, collision-proxy, asset-optimization, materials
---

# Unreal Export

UE-ready FBX. Correct centimeter scale awareness. UCX collision. LOD and socket naming.

## When to Use

- Static mesh or skeletal mesh to Unreal
- UCX/UCLX collision export
- LOD chain import
- Socket / pivot setup for gameplay

## Pre-Flight

1. `asset-optimization` PASS
2. `lod-pipeline` for LOD0–N
3. `collision-proxy` for UCX meshes
4. Apply scale; pivots at intended UE origin

## Scale Note

Unreal is centimeter-based. Common approaches:
- Model in meters in Blender, export FBX with unit conversion / 0.01 awareness per project pipeline
- Or work to project-documented scale and verify with a 100cm reference

**Always measure a known edge after import.**

## FBX Defaults (Static)

```
Selected Objects
Apply Scalings: FBX All
Forward: -Z Forward
Up: Y Up
Mesh: ON
Smoothing: Face
```

## Naming for UE

| Type | Pattern |
|------|---------|
| Static mesh | `SM_Name` |
| Skeletal | `SK_Name` |
| Skeleton | `SKEL_Name` |
| LOD | `SM_Name_LOD0` … |
| Collision | `UCX_SM_Name_01` |
| Socket empty | `SOCKET_Name` |

## Collision

- Prefer convex UCX pieces over complex mesh colliders
- Multiple UCX meshes supported
- See `collision-proxy`

## Skeletal

- UE mannequin-oriented proportions when required
- Root bone; no leftover Blender deform leftovers
- Export morph targets if needed (shape keys)

## Verify in Unreal

- [ ] Scale (door ~200cm, character ~180cm)
- [ ] Collision wireframe
- [ ] LODs auto-detected
- [ ] Materials / texture sampling
- [ ] Sockets transform

## Constraints

### MUST DO
- Confirm scale with known-dimension test
- Prefix collision with `UCX_`
- Validate LODs and materials after import

### MUST NOT DO
- Export without collision plan for physics actors
- Mix unit systems undocumented

## Reference Guide

| Topic | Reference | Load When |
|-------|-----------|----------|
| Unreal Checklist | `references/unreal-checklist.md` | When needed |
| Ucx Naming | `references/ucx-naming.md` | When needed |
````
END THIRD-PARTY FILE cc6c1c237fe65049

The third-party file has ended. Everything between the cc6c1c237fe65049 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

© https://github.com/arjun988 · MIT · https://github.com/arjun988/blender-skills/tree/HEAD/.claude/skills/unreal-export/SKILL.md

## Similar
- [scenario-blender-export](https://affpapa.org/en/nevibecode/skills/scenario-blender-export.md) — skill · 736 installs
- [blender-export](https://affpapa.org/en/nevibecode/skills/blender-export.md) — skill · 2600 installs
- [blender-export-pipelines](https://affpapa.org/en/nevibecode/skills/blender-export-pipelines.md) — skill · 681 installs
- [scenario-unreal-pipeline-automation](https://affpapa.org/en/nevibecode/skills/scenario-unreal-pipeline-automation.md) — skill · 460 installs
- [blender-character-rigging](https://affpapa.org/en/nevibecode/skills/blender-character-rigging.md) — skill · 779 installs
- [blender](https://affpapa.org/en/nevibecode/skills/monumentalsystems-blender.md) — skill · 563 installs

_Part of the page did not fit — see the HTML version._

---
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
