blender-export-pipelines
Export from Blender 5.2 with verified presets - Roblox (FBX/glTF, cages, R15, SurfaceAppearance), Unity (FBX, Humanoid), Unreal (FBX skeletal, Nanite, UCX), Godot/web (GLB, meshopt/Draco, WebP), USD. Scale/axes, smoothing, tangents, leaf bones, clips, batch export, post-export verification. Use whenever an asset leaves Blender.
- License 许可
- MIT
- 最近更新
- 2026-11-14
- Stars
- ★ 1
- Forks
- 1
01 前言 Front Matter
- name
- blender-export-pipelines
- license
- MIT
- metadata
- { "author": "blender-agent-skills", "version": "1.2.0" }
- description
- Export from Blender 5.2 with verified presets - Roblox (FBX/glTF, cages, R15, SurfaceAppearance), Unity (FBX, Humanoid), Unreal (FBX skeletal, Nanite, UCX), Godot/web (GLB, meshopt/Draco, WebP), USD. Scale/axes, smoothing, tangents, leaf bones, clips, batch export, post-export verification. Use whenever an asset leaves Blender.
02 资源文件 6
- 参考文档references/godot-web.md2.8 KB
- 参考文档references/roblox.md3.9 KB
- 参考文档references/unity.md2.3 KB
- 参考文档references/unreal.md3.1 KB
- 脚本scripts/_bpyx.py4.4 KB
- 脚本scripts/export_asset.py8.5 KB
03 SKILL.md 正文
Export Pipelines
The execution model is in blender-core. Run blender-asset-qa (and blender-game-optimization for budgets) before exporting.
One call
scripts/export_asset.py -- --preset unreal_skeletal --objects SK_Hero --out //export/SK_Hero.fbx
scripts/export_asset.py -- --preset web --collection Export --out //export/scene.glb
scripts/export_asset.py -- --preset unity --objects SM_A SM_B SM_C --batch --out //export/x.fbx # one file each, at origin
Presets: roblox, roblox_gltf, unity, unity_skeletal, unreal, unreal_skeletal, godot, web, gltf, usd. Pass any exporter kwarg with --set key=value. Every preset is tested with a round-trip that keeps scale and avoids a 100× armature scale.
Engine reference (load only the one you need)
- references/roblox.md: MeshParts, avatar bodies (R15), accessories, layered clothing cages, SurfaceAppearance, limits
- references/unity.md: FBX settings, Humanoid rigs, URP/HDRP maps, animation clips
- references/unreal.md: static/skeletal FBX, root bone, collision UCX, LODs, Nanite, ORM/DirectX
- references/godot-web.md: glTF/GLB, import suffixes, three.js/Babylon, compression, KHR extensions
Universal pre-export checklist
- Scale: scene unit scale 1.0, objects at scale 1, rotation applied (except intentional object transforms). The presets handle unit conversion.
- Pivot/origin where the engine expects it: props at the bottom-center, characters at the world origin between the feet, facing -Y (Blender front). Every preset converts that to the engine's forward.
- Modifiers: the presets export the evaluated mesh. Mirror, bevel and weighted normals are kept; booleans become real geometry.
- Normals: custom/weighted normals export. Smooth shading, plus hard edges marked sharp.
- Triangulation: FBX presets triangulate (
use_triangles) so the bake and engine tangents match. glTF always triangulates. - Materials: image-texture → Principled chains only, with names
M_*and texturesT_*. Procedural nodes don't export, so bake them first. - Armature: deform bones only, no leaf bones, rest pose = bind pose, 4 weights per vertex max, and the root at the origin.
- Animation: one action per clip, named
Rig_Clip. Bake constraints/IK to keys (blender-animation). FBX exports the active/NLA action per preset settings; glTFACTIONSmode exports every action that has a slot for the armature. - Naming: unique, ASCII, no spaces. Engines key materials/meshes by name across reimports.
Format choice
| Need | Format |
|---|---|
| Unity, Unreal (most stable for skeletal) | FBX |
| Godot, web, Roblox (supported), Unreal 5.x Interchange, Blender↔Blender | glTF 2.0 (.glb) |
Film/VFX, Omniverse, Apple AR (.usdz), layout interchange |
USD |
| Static geometry for printing/CAD | OBJ / STL (wm.obj_export, wm.stl_export) |
| Point caches / deforming sims | Alembic (wm.alembic_export) |
Verify after export (required)
- The script returns
ok, the file size, and for.glba parsed summary (meshes, materials, images, animations, skins, tris, extensions). Compare it with what you expected. - For FBX/USD: re-import into an empty scene (
import_scene.fbx/wm.usd_import) and checkdimensions, the armature scale (must be 1, not 100) and the action count. - In the engine: scale against a reference (UE mannequin 180 cm, Unity capsule 2 m, Roblox character 5 studs), normals/smoothing, the normal map's green channel, and animation root motion.
Collection exporters (re-export in one click, 4.2+)
See blender-scene-setup: collection.exporters stores the format + settings per collection, and bpy.ops.wm.collection_export_all() re-exports everything.
Gotchas
- FBX
use_tspacefails silently on n-gons. Triangulate first (the presets do). bake_space_transform(Apply Transform) is experimental. Use it for Unity static meshes only, never with armatures.- glTF exports actions linked through slots/NLA. An action with no user on the armature is skipped (
export_animation_modeoptions:ACTIONS,ACTIVE_ACTIONS,NLA_TRACKS,SCENE,BROADCAST). - glTF needs image textures in PNG/JPEG/WebP. EXR/TIFF get converted (
export_image_format). - Linked library data exports fine, but make it local or override it if you need to modify it first.
- Shape keys: FBX exports them as blendshapes, glTF as morph targets (
export_morph). Modifiers before the Armature modifier can block shape-key export in FBX (apply them first).
04 同仓库更多 Skills
blender-workflow-recipes
End-to-end Blender 5.2 playbooks chaining the blender-* skills with QA gates - game props (mid-poly, high-to-low), game characters (sculpt/AI mesh to rigged, animated export), Roblox props/accessories/avatars, AI or downloaded asset cleanup, procedural environments, web/AR assets, product turntables, mood/weather shots (night, rain, snow, fog). Use for complete multi-stage asset requests.
blender-weather-fx
Weather effects in Blender 5.2 - looping Geometry Nodes rain, snow, dust, ash and embers with ground hits and splashes, wet surfaces, puddles with animated ripples, wall streaks, snow cover (shader + real snow geometry), storm lightning with multi-stroke flashes and bolts, engine-ready weather masks. Use for rain, storm, snow, wet street, puddle, dust or ember scenes.
blender-video-editing
Video in Blender 5.2 - Video Sequencer edits from Python (clips, image sequences, crossfades, titles, music fades, proxies, color management, H.264/AAC output) and motion tracking (feature detection, camera solve, scene orientation, tripod and plane tracking, stabilization) for VFX shots. Use to cut renders/footage together or match-move a camera.
blender-time-of-day
Time of day and atmosphere in Blender 5.2 - measured sky + sun for dawn, morning, noon, golden hour, sunset, blue hour, overcast, night/moonlight with stars and city glow, exposure balance, height fog from visibility, god rays, Cycles vs EEVEE volumes, compositor grade, stylized moods (cyberpunk neon, horror, underwater, desert). Use for any day/night, sunset, foggy or mood lighting scene.
blender-texturing
Texture authoring in Blender 5.2 - smart-material layers (edge wear, cavity grime, dust, rust, roughness breakup) from curvature/AO masks, z-fight-safe decal and sticker placement, trim sheets, tiling + vertex-color blends, texture painting, baking the look to game texture sets. Use when a material needs wear, dirt, a decal, trims or hand painting, not just wiring.
blender-texture-baking
Bake texture maps in Blender 5.2 Cycles - high-to-low normal maps with cage/extrusion, AO, curvature, ID, thickness, base color/roughness/metallic from procedurals, ORM packing, OpenGL vs DirectX, margins, GPU baking, fixing skewing/waviness/seams. Use when transferring sculpt or high-poly detail to game meshes or converting procedural materials to textures.