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ück | Größe |
|---|---|
| Wandmodul | 4,0 m breit, 0,12 m dick |
| Boden bis Decke | 3,2 m |
| Bodenfliese | 2,0 m |
| Türöffnung | 1,1 m x 2,2 m |
| Treppenstufe | 0,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
- Zuerst Helfer:
box(),cyl(),assign(material),finish()(Transformationen anwenden, per Winkel glätten, UVs). Siehescripts/modular_kit.py, ein kleines funktionierendes Kit als Startvorlage. - Eine Funktion pro Modul (
build_wall,build_floor,build_doorway). Parameter für Varianten (mit oder ohne Abfluss, Gefahrenstreifen, Fenster). - Ein Mesh pro Modul, viele Material-Slots. Teile zusammenfügen. Jedes Modul wird zu einem Objekt und einem Texturset: weniger Draw Calls.
- Backen prozedurale Materialien (Noise, Schmutz, Bump) auf
BaseColor,Normal,MetalSmooth(R = metallic, A = smoothness) undEmission. Prozedurale Nodes überleben den FBX-Export nicht; ohne Backen sieht Unity nur flache Farben. - 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'. - 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.jsonneben der FBX einliest). - Die
.blend-Datei und die Skripte in der Versionsverwaltung behalten. Die FBX ist ein Build-Produkt.