blender_process
Run headless Blender operations on local 3D files to prepare Roblox assets: inspect tri limits, decimate to 20k, split by material, fracture, convert formats, or render preview thumbnails.
Instructions
Run a canned headless-Blender operation on a local 3D file (.glb/.gltf/.fbx/.obj/.blend in; .glb/.fbx out — input is never modified). Actions: inspect (Roblox-readiness lint: tri counts vs the 20k limit, materials-per-mesh, UV sets, texture sizes vs the 1024 cap), decimate (reduce to target tris, default 20000), split_by_material (one object per material — Roblox imports one MeshPart per material object), split_chunks (bisect oversized meshes into ≤target-tri pieces), fracture (Cell Fracture shards for destructibles — needs the Cell Fracture extension installed), set_origins (per-object geometry-median origins), convert (re-export, e.g. obj→glb for import_file), downscale_textures (cap textures at texLimit, default 1024), thumbnail (render a 512px PNG preview of the model — SEE an asset before uploading/spending; returned as an image). Needs Blender installed (free) — auto-detected or TUFAN_BLENDER_PATH.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"inputFile": "<inputFile>",
"action": "<action>"
},
"name": "blender_process"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | Which canned operation to run | |
| shards | No | Shard count for fracture (default 10) | |
| target | No | Tri-count target for decimate/split_chunks (default 20000) | |
| texLimit | No | Max texture dimension for downscale_textures (default 1024) | |
| inputFile | Yes | Absolute path of the local 3D file to process | |
| outputFile | No | Output path (.glb or .fbx). Default: <input dir>/<name>.<action>.glb (inspect: none) | |
| timeoutSeconds | No | Max seconds for the Blender run (default 180, max 600) |