blender-skill

name	blender_skill
version	0.4.0
description	Automazione Blender per 9Lives in due modalita: batch headless e live bridge realtime tramite addon Blender locale. Supporta modellazione base, materiali, luci, camere, render e import/export.
tools	[{"name":"blender.checkAvailability","description":"Verifica se Blender e il runtime Python batch sono disponibili","input":{"type":"object","properties":{}}},{"name":"blender.buildScene","description":"Genera una scena completa in modalita batch/headless a partire da un JSON strutturato","input":{"type":"object","properties":{"scene_name":{"type":"string"},"project_path":{"type":"string"},"save_path":{"type":"string"},"reset_first":{"type":"boolean"},"objects":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["cube","sphere","cylinder","plane","cone","torus","text"]},"name":{"type":"string"},"text":{"type":"string"},"location":{"type":"array","items":{"type":"number"}},"rotation":{"type":"array","items":{"type":"number"}},"scale":{"type":"array","items":{"type":"number"}},"dimensions":{"type":"array","items":{"type":"number"}},"material":{"type":"object"}},"required":["type","name"]}},"lights":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["point","sun","area","spot"]},"name":{"type":"string"},"location":{"type":"array","items":{"type":"number"}},"rotation":{"type":"array","items":{"type":"number"}},"color":{"type":"array","items":{"type":"number"}},"energy":{"type":"number"}},"required":["type","name"]}},"camera":{"type":"object"},"render":{"type":"object"}}}},{"name":"blender.liveStatus","description":"Verifica lo stato del bridge live esposto dall'addon Blender locale","input":{"type":"object","properties":{}}},{"name":"blender.liveSceneState","description":"Legge stato scena, selezione e camera dalla sessione Blender live","input":{"type":"object","properties":{}}},{"name":"blender.liveBuildScene","description":"Costruisce una scena strutturata dentro una sessione Blender GUI gia aperta","input":{"type":"object","properties":{"project_path":{"type":"string"},"save_path":{"type":"string"},"scene_name":{"type":"string"},"reset_first":{"type":"boolean"},"objects":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["cube","sphere","cylinder","plane","cone","torus","text"]},"name":{"type":"string"},"text":{"type":"string"},"location":{"type":"array","items":{"type":"number"}},"rotation":{"type":"array","items":{"type":"number"}},"scale":{"type":"array","items":{"type":"number"}},"dimensions":{"type":"array","items":{"type":"number"}},"material":{"type":"object"}},"required":["type","name"]}},"lights":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["point","sun","area","spot"]},"name":{"type":"string"},"location":{"type":"array","items":{"type":"number"}},"rotation":{"type":"array","items":{"type":"number"}},"color":{"type":"array","items":{"type":"number"}},"energy":{"type":"number"}},"required":["type","name"]}},"camera":{"type":"object"},"render":{"type":"object"}}}},{"name":"blender.liveCreateObject","description":"Crea un oggetto base 3D nella sessione live. Usalo per costruire forme complesse combinando piu primitive come cube, cylinder, plane, sphere, cone, torus e text","input":{"type":"object","properties":{"project_path":{"type":"string"},"save_path":{"type":"string"},"object":{"type":"object","properties":{"type":{"type":"string","enum":["cube","sphere","cylinder","plane","cone","torus","text"]},"name":{"type":"string"},"text":{"type":"string"},"location":{"type":"array","items":{"type":"number"}},"rotation":{"type":"array","items":{"type":"number"}},"scale":{"type":"array","items":{"type":"number"}},"dimensions":{"type":"array","items":{"type":"number"}},"material":{"type":"object"}},"required":["type","name"]}},"required":["object"]}},{"name":"blender.liveModifyObject","description":"Modifica un oggetto esistente nella sessione live con operazioni move, rotate, scale, delete, duplicate, rename, set_origin o parent","input":{"type":"object","properties":{"project_path":{"type":"string"},"save_path":{"type":"string"},"operation_data":{"type":"object","properties":{"target_name":{"type":"string"},"operation":{"type":"string","enum":["move","rotate","scale","delete","duplicate","rename","set_origin","parent"]},"location":{"type":"array","items":{"type":"number"}},"rotation":{"type":"array","items":{"type":"number"}},"scale":{"type":"array","items":{"type":"number"}},"new_name":{"type":"string"},"parent_name":{"type":"string"},"origin_mode":{"type":"string"}},"required":["target_name","operation"]}},"required":["operation_data"]}},{"name":"blender.liveAssignMaterial","description":"Assegna un materiale base a un oggetto nella sessione live","input":{"type":"object","properties":{"project_path":{"type":"string"},"save_path":{"type":"string"},"object_name":{"type":"string"},"material":{"type":"object","properties":{"base_color":{"type":"array","items":{"type":"number"}},"metallic":{"type":"number"},"roughness":{"type":"number"},"transmission":{"type":"number"},"emission_color":{"type":"array","items":{"type":"number"}},"emission_strength":{"type":"number"},"ior":{"type":"number"}}}},"required":["object_name","material"]}},{"name":"blender.liveCreateLight","description":"Crea una luce point, sun, area o spot nella sessione live","input":{"type":"object","properties":{"project_path":{"type":"string"},"save_path":{"type":"string"},"light":{"type":"object","properties":{"type":{"type":"string","enum":["point","sun","area","spot"]},"name":{"type":"string"},"location":{"type":"array","items":{"type":"number"}},"rotation":{"type":"array","items":{"type":"number"}},"color":{"type":"array","items":{"type":"number"}},"energy":{"type":"number"}},"required":["type","name"]}},"required":["light"]}},{"name":"blender.liveCreateCamera","description":"Crea e posiziona una camera nella sessione live","input":{"type":"object","properties":{"project_path":{"type":"string"},"save_path":{"type":"string"},"camera":{"type":"object","properties":{"name":{"type":"string"},"location":{"type":"array","items":{"type":"number"}},"rotation":{"type":"array","items":{"type":"number"}},"lens":{"type":"number"},"set_active":{"type":"boolean"}}}},"required":["camera"]}},{"name":"blender.liveRenderStill","description":"Renderizza un'immagine dalla sessione Blender live","input":{"type":"object","properties":{"project_path":{"type":"string"},"save_path":{"type":"string"},"render":{"type":"object","properties":{"engine":{"type":"string","enum":["EEVEE","BLENDER_EEVEE","CYCLES"]},"resolution_x":{"type":"number"},"resolution_y":{"type":"number"},"samples":{"type":"number"},"transparent_background":{"type":"boolean"},"background_color":{"type":"array","items":{"type":"number"}},"output_path":{"type":"string"}},"required":["output_path"]}},"required":["render"]}},{"name":"blender.liveImportAsset","description":"Importa OBJ o GLTF/GLB nella sessione Blender live","input":{"type":"object","properties":{"project_path":{"type":"string"},"save_path":{"type":"string"},"input_path":{"type":"string"},"format":{"type":"string","enum":["obj","glb","gltf"]}},"required":["input_path"]}},{"name":"blender.liveExportAsset","description":"Esporta la scena live in OBJ, GLTF/GLB o FBX","input":{"type":"object","properties":{"project_path":{"type":"string"},"output_path":{"type":"string"},"format":{"type":"string","enum":["obj","glb","gltf","fbx"]}},"required":["output_path"]}},{"name":"blender.liveSelectObjects","description":"Seleziona uno o piu oggetti nella sessione Blender live","input":{"type":"object","properties":{"object_names":{"type":"array","items":{"type":"string"}}},"required":["object_names"]}},{"name":"blender.liveViewportPreview","description":"Salva una preview viewport PNG dalla sessione Blender live","input":{"type":"object","properties":{"output_path":{"type":"string"}},"required":["output_path"]}},{"name":"blender.liveExecute","description":"Tool avanzato generico per eseguire azioni realtime whitelistate sul bridge Blender live quando non esiste un tool piu specifico","input":{"type":"object","properties":{"action":{"type":"string"},"payload":{"type":"object"},"timeout_ms":{"type":"number"}},"required":["action"]}}]

Regole d'uso

• Usa la modalita blender.* batch quando devi eseguire job headless, render deterministici o pipeline senza GUI.
• Usa la modalita blender.live* quando Blender gira sulla macchina locale con addon 9Lives Live Bridge attivo e serve interazione realtime.
• Per modellazione 3D di oggetti complessi usa una strategia compositiva: crea piu primitive con blender.liveCreateObject, poi rifiniscile con blender.liveModifyObject, assegna materiali con blender.liveAssignMaterial e infine aggiungi luci/camera/render.
• Una poltrona, una sedia o un tavolo non richiedono mesh custom: costruiscili come insieme di seduta, schienale, braccioli, gambe e cuscini usando cube, cylinder, plane e torus con scale/rotation/location diverse.
• Usa blender.liveBuildScene quando hai gia una descrizione JSON strutturata di tutti gli oggetti da creare in un colpo solo.
• Usa blender.liveExecute solo come fallback avanzato quando il bridge supporta gia un'azione whitelistata ma non esiste ancora un tool dedicato piu leggibile.
• Prima di usare i tool live esegui blender.liveStatus per verificare bridge, token e scena raggiungibile.
• Tutte le azioni live sono whitelistate e serializzate sul main thread di Blender; non usare input arbitrari o codice Python libero.
• Mantieni BLENDER_LIVE_BASE_URL e BLENDER_LIVE_TOKEN configurati nel gateway quando il bridge Blender gira fuori dal container 9Lives.