Deutsch — Offizielle Deutsch-Version / Documento Oficial en Deutsch.
English Translation — Official English version of
using-blender.
Using Blender (Deutsch)
Kernregel
Arbeite mit Blender in drei Modi, passend zur Aufgabe:
- GUI-Modus: Blender sichtbar öffnen, wenn der Nutzer ein Asset anschauen, beurteilen oder manuell weiterbearbeiten will.
- Headless-Modus:
blender --background --python <script.py>nutzen, wenn Export, Reimport, Batch-Verarbeitung oder deterministische Prüfung gefragt ist. - MCP-Modus: Nur verwenden, wenn ein laufendes Blender-Addon bewusst verbunden ist und Live-Szenensteuerung nötig ist. Vorher Sicherheits- und Lizenzlage prüfen.
Standardablauf
- Ziel klären: ansehen, erzeugen, konvertieren, optimieren, rendern oder verifizieren.
- Bestehende Dateien lesen: Manifest, README, Exportformate und vorhandene Prüfergebnisse zuerst.
- Blender-Pfad ermitteln:
blenderauf PATH, projektspezifische Konfiguration oder Nutzerpfad. Keine lokalen Privatpfade in publizierbare Doku schreiben. - Für Automatisierung ein kleines
bpy-Script verwenden, das Eingaben, Ausgaben und Fehler explizit macht. - Nach jedem Export mindestens einen Reimport- oder Ladecheck ausführen, bevor das Ergebnis als nutzbar gilt.
- Artefakte knapp dokumentieren: Quelle, Exportformate, Toolversion, Prüfstatus und bekannte Grenzen.
Export- und Prüfregeln
- Für allgemeine Web-/Preview-Nutzung bevorzugt
.glb. - Für Game-Engines und DCC-Austausch zusätzlich
.fbxoder.obj/.mtlanbieten, wenn der Zielworkflow das braucht. - Für Roundtrips immer prüfen: Datei existiert, nicht leer, kann reimportiert werden, erwartete Objekt-/Materialnamen sind vorhanden.
- Für große Assets Metriken erfassen: Mesh-Anzahl, Materialien, Bounding Box, Dateigröße und optional Triangle Count.
- Für Renderprüfungen kleine Preview-Auflösung verwenden, bevor teure Cycles- oder Full-HD-Renders gestartet werden.
Sicherheitsregeln
bpy-Code ist lokaler Python-Code mit Dateisystemzugriff. Nur selbst geschriebene oder auditierte Scripts ausführen.- Keine fremden Blender-Addons, Asset-Downloader oder Telemetrie-Server aktivieren, ohne Lizenz- und Datenschutzcheck.
- Bei MCP-Servern mit beliebigem
execute_python-Tool vorher Scope, Netzwerk, Arbeitsverzeichnis und Timeout begrenzen. - Bei Marketplace- oder externen Assets die Lizenz separat prüfen. Die technische Ladefähigkeit ersetzt keine Nutzungsrechte.
MCP-Optionen
Für Live-Steuerung lies references/blender-mcp-review.md, wenn ein Blender-MCP-Server ausgewählt, installiert oder bewertet werden soll.
Änderungsprotokoll
1.0.0 (2026-06-20)
- Initialer nutzeragnostischer Blender-Skill mit GUI-, Headless- und MCP-Routing.