CommunityImagegithub.com

kit-de-jeux-blender

Créez des modèles prêts pour le jeu à partir de Python dans Blender pour n'importe quel jeu - kits de niveaux modulaires (murs, sols, portes, escaliers, plateformes, plafonds), accessoires et personnages simples - cuisez les matériaux procéduraux en textures, créez des copies LOD bon marché et exportez FBX qui s'intègre directement dans Unity ou un autre moteur. Utilisez-le lorsque l'utilisateur souhaite des modèles 3D ou des niveaux depuis Blender, dit "Blender MCP", "fabriquer un kit modulaire", "modéliser une pièce/un donjon/une maison/un couloir/des accessoires", "exporter vers Unity", "trop de triangles", ou veut de l'art qu'il peut régénérer à partir du code au lieu de modéliser à la main.

Qu'est-ce que kit-de-jeux-blender ?

Ce kit permet à un agent IA (comme Claude Code, Cursor ou Codex) de construire des mondes de jeu entiers en exécutant des scripts Python dans Blender. L'agent peut opérer en mode Live (via l'add-on Blender MCP) pour explorer et vérifier l'aspect visuel, ou en mode Headless (`blender -b ...`) pour des exportations reproductibles. Le design est basé sur une grille modulaire : l'agent choisit d'abord les tailles des modules (murs, sols, portes, etc.) en fonction du personnage du jeu, puis écrit des fonctions Python (une par module) qui génèrent un mesh, cuisent les matériaux procéduraux en textures (BaseColor, Normal, MetalSmooth, Emission) et exportent en FBX avec des réglages spécifiques à Unity. Le flux de travail inclut la validation automatique du nombre de triangles et des budgets pour éviter les régressions, ainsi que la création de copies `_Lite` pour les pièces éloignées. Le résultat est un FBX prêt à être importé dans Unity avec des colliders simples et un fichier `materials.json` pour lier les textures.

Compatible avec~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 Image skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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èceTaille
Module mural4,0 m de large, 0,12 m d'épaisseur
Du sol au plafond3,2 m
Carreau de sol2,0 m
Ouverture de porte1,1 m sur 2,2 m
Marche d'escalier0,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

  1. D'abord les aides : box(), cyl(), assign(material), finish() (appliquer les transformations, lisser par angle, UVs). Voir scripts/modular_kit.py, un petit kit fonctionnel pour commencer.
  2. Une fonction par module (build_wall, build_floor, build_doorway). Paramètres pour les variantes (avec ou sans drain, bande de danger, fenêtre).
  3. 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.
  4. Cuisez les matériaux procéduraux (bruit, saleté, bosselage) en BaseColor, Normal, MetalSmooth (R = métallique, A = lissage) et Emission. Les nœuds procéduraux ne survivent pas à l'exportation FBX ; sans cuisson, Unity ne voit que des couleurs unies.
  5. 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'.
  6. É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 _Lite pour 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 .blend et les scripts dans le contrôle de version. Le FBX est un produit de construction.

Individual skills in this repo

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

Skills associés