CommunityBildgithub.com

Blender Game Kit (Modelle aus Code)

Erstelle spielfertige 3D-Modelle mittels Python in Blender – modulare Level-Kits (Wände, Böden, Türen, Treppen, Plattformen, Decken), Requisiten und einfache Charaktere. Backe prozedurale Materialien in Texturen, erzeuge günstige LOD-Kopien und exportiere FBX-Dateien, die direkt in Unity oder andere Engines importiert werden können.

Was ist Blender Game Kit (Modelle aus Code)?

Dieses Skill befähigt einen KI-Agenten, 3D-Modelle und komplette Level für Spiele direkt aus Python-Skripten in Blender zu generieren. Es ist besonders nützlich, wenn der Benutzer modulare Level-Kits (z. B. Dungeons, Häuser, Korridore) oder einzelne Requisiten benötigt und diese lieber per Code statt von Hand modellieren möchte. Der Skill unterstützt sowohl die interaktive Nutzung mit dem Blender MCP Add-on (für schnelles Feedback) als auch den Headless-Modus (`blender -b -P build_kit.py`) für reproduzierbare Game-Exports. Der gesamte Workflow basiert auf einem strengen Raster (Grid), wobei Module wie Wände, Böden, Türen und Treppen als einzelne Objekte mit mehreren Material-Slots erstellt, prozedurale Materialien in Texturen gebacken und schließlich als FBX mit Unity-kompatiblen Achsen exportiert werden. Der Skill erzeugt außerdem eine Validierungsdatei mit Dreieckszahlen, Abmessungen und Materialanzahlen, um Qualitätsregressionen zu erkennen und Budgets einzuhalten.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Maimuzamilhu/claude-code-gamedev-pipeline/tree/HEAD/skills/blender-game-kit

Installed? Explore more Bild skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht Blender Game Kit (Modelle aus Code)?

Erstelle die Spielwelt mit Python-Skripten, die in Blender ausgeführt werden. Ein Verlies, ein Haus, eine Raumstation, ein Stadtblock: Alles besteht aus Modulen auf einem Raster plus Requisiten. Eine Änderung bedeutet eine Bearbeitung und einen erneuten Durchlauf, niemals stundenlanges Nachmodellieren.

Beispiel (HOLD STILL): Die gesamte zweistöckige Fabrik (Wände, Böden, Türen, Treppen, Labormöbel, Roboter, Schutt) entstand aus etwa 20 Blender-Skripten.

Wie der Agent Blender ausführt

  • Live-Blender (Blender MCP Add-on): Python im geöffneten Blender des Benutzers ausführen, den Viewport betrachten, Poly Haven / Sketchfab-Assets suchen und importieren. Am besten zum Erkunden und Prüfen der Optik.
  • Headless (für den echten Export): blender -b --factory-startup -P build_kit.py. Gleiches Ergebnis bei jedem Durchlauf, kein UI-Status schleicht sich ein. Für alles verwenden, was im Spiel landet.

Shader-Nodes immer nach Typ suchen, niemals nach Namen (Namen werden in anderen UI-Sprachen übersetzt): next(n for n in mat.node_tree.nodes if n.type == "BSDF_PRINCIPLED").

Das Raster ist das Design

Wähle zuerst die Modulgrößen und weiche nie davon ab. Passe sie an deinen Charakter an: Türen etwas breiter und höher als die Spielerkapsel, Stufen niedriger als die Schrittgröße. Ein guter Start für einen menschlichen Charakter (das sind HOLD STILLs Zahlen):

StückGröße
Wandmodul4,0 m breit, 0,12 m dick
Boden bis Decke3,2 m
Bodenfliese2,0 m
Türöffnung1,1 m x 2,2 m
Treppenstufe0,18 m Höhe (unter der Schrittgröße des Charakters bleiben)

Drehe das Modul so, dass der Pivot im Mittelpunkt des Bodens liegt – dann rasten die Teile in Unity auf ganzen Metern ein.

Arbeitsablauf

  1. Zuerst Helfer: box(), cyl(), assign(material), finish() (Transformationen anwenden, per Winkel glätten, UVs). Siehe scripts/modular_kit.py, ein kleines funktionierendes Kit als Startvorlage.
  2. Eine Funktion pro Modul (build_wall, build_floor, build_doorway). Parameter für Varianten (mit oder ohne Abfluss, Gefahrenstreifen, Fenster).
  3. Ein Mesh pro Modul, viele Material-Slots. Teile zusammenfügen. Jedes Modul wird zu einem Objekt und einem Texturset: weniger Draw Calls.
  4. Backen prozedurale Materialien (Noise, Schmutz, Bump) auf BaseColor, Normal, MetalSmooth (R = metallic, A = smoothness) und Emission. Prozedurale Nodes überleben den FBX-Export nicht; ohne Backen sieht Unity nur flache Farben.
  5. FBX exportieren mit Unity-Achsen: axis_forward='-Z', axis_up='Y', apply_scale_options='FBX_SCALE_ALL', use_tspace=True, mesh_smooth_type='FACE', path_mode='STRIP'.
  6. Validierungsdatei schreiben nach dem Export: pro Modul Dreieckszahl, Abmessungen, Materialanzahl. Mit dem vorherigen Durchlauf vergleichen, um Regressionen als Zahlen sichtbar zu machen.

Dreiecksbudgets (was zählt)

  • Zähle, wohin die Dreiecke gehen, bevor du optimierst. Beispiel: In HOLD STILL machten drei Deckenelemente 38,6 % aller Dreiecke in der Szene aus, wegen 2-mm-Fasen, die niemand aus 2 m Entfernung sieht. Eine planare Dezimation (nahezu koplanare Flächen auflösen, 50 Grad, begrenzt durch UV-Nähte und Material) hat sie massiv reduziert, ohne sichtbare Änderung. Siehe references/budgets.md.
  • Kleine Fasen sind für Nahaufnahme-Heldenrequisiten, nicht für wiederholte Module.
  • Erstelle _Lite-Kopien für entfernte oder wiederholte Teile, anstatt das Quellkit zu bearbeiten.

Übergabe an Unity

  • Importeinstellungen: Collider nur für die Teile generieren, die der Spieler berührt; für den Rest einfache Box-Collider verwenden.
  • Die gebackenen Texturen über ein URP Lit-Material pro Modul per Name zuweisen (ein kleines Editor-Skript, das eine materials.json neben der FBX einliest).
  • Die .blend-Datei und die Skripte in der Versionsverwaltung behalten. Die FBX ist ein Build-Produkt.

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

Verwandte Skills