Kit de jeu Blender (modèles à partir de code)
Construisez le monde du jeu à partir de scripts Python exécutés dans Blender. Un donjon, une maison, une station spatiale, un pâté de maisons : tout est modules sur une grille plus des accessoires. Une modification est une édition et une ré-exécution, jamais des heures de remodélisation.
Exemple (HOLD STILL) : l'ensemble de l'usine à deux étages (murs, sols, portes, escaliers, mobilier de laboratoire, robots, débris) provient d'environ 20 scripts Blender.
Comment l'agent exécute Blender
- Blender en direct (add-on Blender MCP) : exécutez Python dans Blender ouvert de l'utilisateur, regardez la fenêtre d'affichage, recherchez et importez des ressources Poly Haven / Sketchfab. Idéal pour explorer et vérifier l'apparence.
- Sans interface (pour la véritable exportation) :
blender -b --factory-startup -P build_kit.py. Même résultat à chaque exécution, aucun état d'interface utilisateur ne s'infiltre. Utilisez ceci pour tout ce que le jeu embarque.
Recherchez les nœuds de shader par type, jamais par nom (les noms sont traduits dans d'autres langues d'interface utilisateur) :
next(n for n in mat.node_tree.nodes if n.type == "BSDF_PRINCIPLED").
La grille est la conception
Choisissez d'abord les tailles des modules et ne les modifiez jamais. Adaptez-les à votre personnage : portes un peu plus larges et plus hautes que la capsule du joueur, marches plus basses que sa hauteur de marche. Un bon début pour un personnage de taille humaine (ce sont les chiffres de HOLD STILL) :
| Pièce | Taille |
|---|---|
| Module mural | 4,0 m de large, 0,12 m d'épaisseur |
| Du sol au plafond | 3,2 m |
| Carreau de sol | 2,0 m |
| Ouverture de porte | 1,1 m sur 2,2 m |
| Marche d'escalier | 0,18 m de hauteur (restez en dessous de la hauteur de marche du personnage) |
Pivotez au centre du sol du module pour que les pièces s'emboîtent sur des mètres entiers dans Unity.
Flux de travail
- D'abord les aides :
box(),cyl(),assign(material),finish()(appliquer les transformations, lisser par angle, UVs). Voirscripts/modular_kit.py, un petit kit fonctionnel pour commencer. - Une fonction par module (
build_wall,build_floor,build_doorway). Paramètres pour les variantes (avec ou sans drain, bande de danger, fenêtre). - Un mesh par module, plusieurs emplacements de matériaux. Fusionnez les parties. Chaque module devient un objet et un ensemble de textures : moins d'appels de dessin.
- Cuisez les matériaux procéduraux (bruit, saleté, bosselage) en
BaseColor,Normal,MetalSmooth(R = métallique, A = lissage) etEmission. Les nœuds procéduraux ne survivent pas à l'exportation FBX ; sans cuisson, Unity ne voit que des couleurs unies. - Exportez FBX avec les axes d'Unity :
axis_forward='-Z', axis_up='Y', apply_scale_options='FBX_SCALE_ALL', use_tspace=True, mesh_smooth_type='FACE', path_mode='STRIP'. - Écrivez un fichier de validation après l'exportation : par module, nombre de triangles, limites, nombre de matériaux. Comparez-le avec l'exécution précédente afin que les régressions apparaissent sous forme de nombres.
Budgets de triangles (ce qui importait)
- Comptez où vont les triangles avant d'optimiser. Exemple : dans HOLD STILL, trois carreaux de plafond représentaient 38,6 % de tous les triangles de la scène à cause de biseaux de 2 mm que personne ne peut voir à 2 m en dessous. Une décimation planaire (dissoudre les faces quasi-coplanaires, 50 degrés, délimitée par les coutures UV et le matériau) les a fortement réduits sans changement visible. Voir
references/budgets.md. - Les petits biseaux sont réservés aux accessoires héroïques en gros plan, pas aux modules répétés.
- Créez des copies
_Litepour les pièces éloignées ou répétées au lieu de modifier le kit source.
Transfert vers Unity
- Paramètres d'importation : générez des colliders uniquement sur les pièces que le joueur touche ; utilisez des colliders en boîte simple pour le reste.
- Liez les textures cuites à un matériau URP Lit par module par nom (un petit script d'éditeur qui lit un
materials.jsonécrit à côté du FBX). - Gardez le
.blendet les scripts dans le contrôle de version. Le FBX est un produit de construction.