Communitygithub.com

dnlgalleguillos/gauge-modeling

Modélisez des maillages de surfaces dures et d'accessoires dans Blender avec bmesh et vérifiez-les avec des nombres - n-gons, trous, normales inversées, géométrie dupliquée et lâche, densité UV. Livre un kit de pièces biseautées, un script de porte et de réparation sécurisée. Utilisez-le lors de la construction ou de la révision de tout maillage.

Qu'est-ce que gauge-modeling ?

Ce skill permet de modéliser des maillages de surfaces dures et d'accessoires dans Blender en utilisant l'API `bmesh`/data, qui fonctionne sans contexte d'interface utilisateur (UI), et de valider mathématiquement la qualité du maillage via une « porte » (gate) qui évalue le maillage après application des modificateurs et Geometry Nodes. Il fournit un kit de construction de pièces biseautées (boîtes, cylindres, têtes de boulons), un script de porte et un script de réparation sécurisée qui n'affecte que la sélection. Le skill est particulièrement utile pour les développeurs d'outils Blender, les artistes techniques et les ingénieurs qui ont besoin de garantir la propreté du maillage (pas de géométrie lâche, de faces à aire nulle, de normales inversées, de n-gons excessifs, etc.) avant l'exportation vers les moteurs de jeu. Il supporte l'intégration avec Claude Code et Cursor via des scripts exécutés en ligne de commande, et propose une vérification systématique après chaque modification.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/dnlgalleguillos/blender-gauge/tree/HEAD/skills/gauge-modeling

Demander à votre IA préférée

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

Documentation

Modélisation Gauge

Construisez avec l'API bmesh/data (fonctionne sans contexte d'interface utilisateur), puis passez le maillage évalué par la porte pour que les modificateurs et Geometry Nodes soient comptabilisés.

Construction

scripts/kit.py (importez-le depuis un script situé à côté) :

FonctionProduit
rounded_box(name, size, bevel, segments, loc, rot, collection)boîte avec de vrais biseaux dans le maillage, lissage par angle
cylinder(name, radius, depth, segments, bevel, ...)cylindre avec des capuchons biseautés
bolt_head(name, radius, height, sides, bevel, ...)tête de boulon hexagonale (ou ronde)
cut_holes(target, [(u, v, r), ...])trous ronds traversant l'axe le plus fin (booléen, puis cuit)
bake_modifiers(ob)applique toute la pile sans bpy.ops
assign(ob, material)un seul emplacement de matériau

Les constructeurs remplacent un objet du même nom, donc les scripts peuvent être réexécutés. scripts/build_prop.py construit un accessoire entier à partir d'une liste de pièces JSON (ou de la caisse de démonstration) dans sa propre collection et le passe par la porte :

run_blender_script path=skills/gauge-modeling/scripts/build_prop.py args={"name": "crate", "spec": "parts.json"}

Porte

scripts/mesh_gate.py -> porte mesh-health.

VérificationÉchoue quandCorrection typique
loose_verts, zero_area_faces, duplicate_vertsn'importe quandfix_mesh.py
non_manifold_edgesune arête partagée par 3+ facesreconstruire cette zone
inverted_volumemaillage fermé avec volume négatiffix_mesh.py (normals)
ngonsplus de max_ngons (optionnel)fix_mesh.py avec triangulate_ngons, ou re-quadriller
trianglesplus de max_tris (optionnel)décimer, moins de segments de biseau
closed_meshesrequire_closed et un trou existeremplir
has_uv, texel_density_cvrequire_uv / limite donnéedéplier, équilibrer l'échelle des îlots

fix_mesh.py est une simulation jusqu'à ce que apply=true ; il ne touche jamais aux données de maillage partagées utilisées en dehors de la sélection.

Règles

  • Taille réelle d'abord (mètres), puis biseau : un biseau est une fraction de la plus petite dimension (1-4 %). Les arêtes vives sans biseau n'accrochent pas la lumière.
  • Biseau avant lissage ; lisser par angle (35 degrés) au lieu des drapeaux par face.
  • Les booléens laissent des n-gons sur les faces coupées : correct pour les images fixes, trianguler avant l'exportation vers les moteurs.
  • Gardez les pièces comme des objets nommés séparés jusqu'à la fin ; ne joindre que pour l'exportation.
  • Après tout changement : passer par la porte, puis look depuis angles en ombrage argile pour juger de la forme.

Individual skills in this repo

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

Skills associés