Communitygithub.com

dnlgalleguillos/gauge-modeling

Modela mallas de superficies duras y props en Blender con bmesh y verifícalas numéricamente: n-gonos, agujeros, normales invertidas, geometría duplicada y suelta, densidad UV. Incluye un kit de piezas biseladas, un compuerta y un script de reparación segura. Úsalo al construir o revisar cualquier malla.

¿Qué es gauge-modeling?

Este skill permite modelar mallas de superficies duras y props en Blender utilizando la API de datos `bmesh`, funcionando sin contexto de interfaz de usuario. Su propósito es ayudar a creadores y revisores a construir geometría limpia y a verificar su salud mediante comprobaciones numéricas automatizadas (n-gonos, agujeros, normales invertidas, geometría duplicada/suelta y densidad UV). Incluye un kit de piezas biseladas (cajas redondeadas, cilindros, cabezas de perno) y scripts para construir props completos a partir de listas JSON, además de un sistema de compuerta (`gate`) que evalúa la malla después de aplicar modificadores y nodos de Geometry Nodes. Todo el flujo está diseñado para ser repetible: los scripts se pueden re-ejecutar sin duplicar objetos, y las reparaciones son seguras (solo se aplican si se solicita explícitamente). Está pensado para entornos como Blender 4.2+ y puede integrarse en pipelines de automatización (por ejemplo, desde la terminal o desde un script externo).

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Gauge modeling

Construye con la API de datos bmesh (funciona sin contexto de interfaz de usuario), luego aplica la compuerta a la malla evaluada para que los modificadores y Geometry Nodes sean contabilizados.

Construcción

scripts/kit.py (impórtalo desde un script junto a él):

FunciónCrea
rounded_box(name, size, bevel, segments, loc, rot, collection)caja con biseles reales en la malla, suavizado por ángulo
cylinder(name, radius, depth, segments, bevel, ...)cilindro con tapas biseladas
bolt_head(name, radius, height, sides, bevel, ...)cabeza de perno hexagonal (o redonda)
cut_holes(target, [(u, v, r), ...])agujeros redondos a través del eje más delgado (booleano, luego horneados)
bake_modifiers(ob)aplica toda la pila sin bpy.ops
assign(ob, material)ranura de material único

Los constructores reemplazan un objeto con el mismo nombre, por lo que los scripts se pueden re-ejecutar. scripts/build_prop.py construye un prop completo a partir de una lista JSON de piezas (o el demo de caja) en su propia colección y le aplica la compuerta:

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

Compuerta

scripts/mesh_gate.py → compuerta mesh-health.

ComprobaciónFallo cuandoArreglo típico
loose_verts, zero_area_faces, duplicate_vertscualquierafix_mesh.py
non_manifold_edgesarista compartida por 3+ carasreconstruir esa zona
inverted_volumemalla cerrada con volumen negativofix_mesh.py (normals)
ngonsmás de max_ngons (opt-in)fix_mesh.py con triangulate_ngons, o re-cuadrangular
trianglesmás de max_tris (opt-in)decimar, menos segmentos de bisel
closed_meshesrequire_closed y existe un agujerorellenar
has_uv, texel_density_cvrequire_uv / límite dadodesenvolver, igualar escala de islas

fix_mesh.py es una simulación hasta que apply=true; nunca toca datos de malla compartidos fuera de la selección.

Reglas

  • Primero el tamaño del mundo real (metros), después el bisel: un bisel es una fracción de la dimensión más pequeña (1-4 %). Las aristas duras sin bisel no captan luz.
  • Bisel antes de suavizar; suavizar por ángulo (35 grados) en lugar de por banderas por cara.
  • Los booleanos dejan n-gonos en las caras cortadas: está bien para imágenes fijas, triangular antes de exportar a motores.
  • Mantén las piezas como objetos separados con nombre hasta el final; únelas solo para exportar.
  • Después de cualquier cambio: aplica la compuerta, luego look desde angles en sombreado de arcilla para juzgar la forma.

Individual skills in this repo

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

Skills relacionados