Skip to content

blender-web-pipeline

  • Group: 3D / WebGL
  • When it activates: Exporting/optimizing Blender models to glTF for the web
  • Installed: Optional: comes with a skill bundle.

Full upstream documentation (English): SKILL.upstream.md (613 lines). Don’t read it all: use the map and read only the section you need (Read with offset/limit or Grep).

  • Use: exporting .blend to .glb with Draco compression and reduced textures for Three.js, R3F, Babylon or PlayCanvas.
  • Use: automating with blender --background --python, processing batches, generating LODs, baking complex materials.
  • Use: a .glb is too heavy, textures are missing, the animation doesn’t play or materials look different on the web.
  • Do NOT use: loading/rendering the model in the browser → threejs-webgl, react-three-fiber, babylonjs-engine, playcanvas-engine.
  • Do NOT use: painting PBR textures → substance-3d-texturing; 3D integration patterns on the web → web3d-integration-patterns.
Task Read only
Start a project/starter (first export) SKILL.upstream.md L80-110 (§1. Basic glTF Export) + L572-588 (§Export Settings)
Batch / CLI export L112-168 (§2. Python Script for Batch Export) + L324-359 (§7. Command-Line Automation) or scripts/batch_export.py
Reduce weight (polygons, textures, LOD) L170-195 (§3. Decimation), L253-322 (§5-6 LOD and compression) + references/optimization_strategies.md
Load the .glb in Three/R3F/Babylon L361-419 (§Integration Patterns)
Debugging / performance L489-551 (§Common Pitfalls) + L553-570 (§Pre-Export Checklist)
Lines Section What for
8-27 Overview Scope and capabilities of the pipeline
28-77 Core Concepts glTF vs GLB, bpy basics, target metrics (<5 MB, <50k tris, 2048 px max)
78-359 Common Patterns Basic export, batch, decimation, baking, LODs, texture compression, CLI
197-251 4. Texture Baking for Web Bake materials into a single texture with Cycles
361-419 Integration Patterns Loading with GLTFLoader+DRACOLoader, useGLTF, SceneLoader.ImportMesh
421-487 Optimization Techniques Remove doubles, triangulate, JPEG, UV atlas, Principled BSDF
489-551 Common Pitfalls Huge files, missing textures, animations, materials, slow export, lag
553-588 Best Practices Pre-export checklist and recommended export_scene.gltf parameters
590-613 Resources / Related Skills Index of scripts, references and related skills
  • references/gltf_export_guide.md — Full reference of glTF export options.
  • references/bpy_api_reference.md — Blender Python API cheat sheet.
  • references/optimization_strategies.md — Detailed optimization techniques (geometry, textures, materials).
  • scripts/batch_export.py — Exports every .blend in a folder to .glb: blender --background --python scripts/batch_export.py -- /entrada /salida.
  • scripts/optimize_model.py — Decimates and downsizes the textures of a model: blender --background modelo.blend --python scripts/optimize_model.py.
  • scripts/generate_lods.py — Generates LOD0-2 copies: blender --background modelo.blend --python scripts/generate_lods.py.
  • assets/README.md — Description only; upstream cites export_template.blend and shader_library/ but they do NOT exist in the package.
  • Always export binary GLB with export_apply=True and Draco enabled (level 6; 8 if size matters most); target <5 MB (ideally <1 MB) and <50k triangles.
  • Textures at most 2048 px (1024 preferred), JPEG at quality 85 unless alpha is needed; no exported lights or cameras (recreate them in code).
  • Only Principled BSDF materials with supported channels (Base Color, Metallic, Roughness, Normal, Emission); custom nodes are not exported.
  • Before exporting: apply modifiers and transforms, merge by distance, clean orphan data, animations on the timeline with assigned actions.
  • If you use Draco, the website must register the decoder (DRACOLoader.setDecoderPath), or the model won’t load.
  • Detect the stack as the front-activation/skill-router skill says (senzu/senzu.json → package.json). This skill runs outside the front end (Blender + Python); its .glb output is consumed from threejs-webgl (vanilla/Vue/Astro), react-three-fiber (React) or babylonjs-engine. Put the .glb files in public/models/ and the Draco decoder in public/draco/.