Communitygithub.com

dnlgalleguillos/gauge-modeling

Modelliere Hartflächen- und Requisiten-Meshes in Blender mit bmesh und prüfe sie mit Zahlen – N-Gons, Löcher, umgekehrte Normalen, doppelte und lose Geometrie, UV-Dichte. Enthält ein Kit mit abgefasten Teilen, einem Tor und einem Reparatur-Skript. Verwende es beim Erstellen oder Überprüfen eines beliebigen Meshes.

Was ist gauge-modeling?

Dieses Skill ermöglicht es, harte Oberflächen und Requisiten-Meshes in Blender mit der bmesh/Data-API zu modellieren – ohne UI-Kontext. Es bietet eine Reihe von Bausteinen (z. B. abgefaste Boxen, Zylinder, Sechskantschraubenköpfe) und ein System, um das evaluierte Mesh durch Modifier und Geometry Nodes zu 'schleusen'. Ein integrierter 'Mesh Gate' prüft automatisch auf Probleme wie lose Vertices, nicht-manifold Kanten, invertiertes Volumen, N-Gons und UV-Dichte; die Reparatur erfolgt wahlweise per Script. Das Skill unterstützt jeden Blender-Workflow (Headless, Scripting, UI) und ist besonders nützlich für Entwickler, die saubere, überprüfbare 3D-Modelle für Engines oder weitere Verarbeitung benötigen.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Gauge-Modellierung

Erstelle mit der bmesh/Data-API (funktioniert ohne UI-Kontext), schleuse dann das evaluierte Mesh, damit Modifier und Geometry Nodes berücksichtigt werden.

Bauen

scripts/kit.py (importiert es aus einem Skript daneben):

FunktionErzeugt
rounded_box(name, size, bevel, segments, loc, rot, collection)Box mit echten Abschrägungen im Mesh, glatt nach Winkel
cylinder(name, radius, depth, segments, bevel, ...)Zylinder mit abgefasten Kappen
bolt_head(name, radius, height, sides, bevel, ...)Sechskant- (oder runder) Schraubenkopf
cut_holes(target, [(u, v, r), ...])runde Löcher durch die dünnste Achse (boolean, dann gebacken)
bake_modifiers(ob)wendet den gesamten Stack an, ohne bpy.ops
assign(ob, material)einzelner Material-Slot

Builder ersetzen ein Objekt mit demselben Namen, sodass Skripte erneut ausgeführt werden können. scripts/build_prop.py baut ein ganzes Requisit aus einer JSON-Teileliste (oder der Demo-Kiste) in eine eigene Sammlung und schleust es:

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

Schleuse (Gate)

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

PrüfungSchlägt fehl beiTypische Korrektur
loose_verts, zero_area_faces, duplicate_vertsirgendetwasfix_mesh.py
non_manifold_edgesKante, von 3+ Flächen geteiltBereich neu aufbauen
inverted_volumegeschlossenes Mesh mit negativem Volumenfix_mesh.py (normals)
ngonsmehr als max_ngons (Opt-in)fix_mesh.py mit triangulate_ngons, oder neu quaddeln
trianglesmehr als max_tris (Opt-in)dezimieren, weniger Abfasungssegmente
closed_meshesrequire_closed und es existiert ein Lochfüllen
has_uv, texel_density_cvrequire_uv / vorgegebenes Limitentfalten, Inselmaßstab angleichen

fix_mesh.py ist ein Probelauf bis apply=true; es berührt niemals gemeinsame Mesh-Daten, die außerhalb der Auswahl verwendet werden.

Regeln

  • Zuerst echte Weltgröße (Meter), dann Abschrägung: Eine Abschrägung ist ein Bruchteil der kleinsten Abmessung (1–4 %). Harte Kanten ohne Abschrägung fangen kein Licht ein.
  • Abschrägung vor Glättung; nach Winkel glätten (35°) statt nach Flächen-Flags.
  • Boolesche Operationen hinterlassen N-Gons auf Schnittflächen: für Standbilder in Ordnung; vor dem Export in Engines triangulieren.
  • Teile bis zum Ende als separate benannte Objekte behalten; erst zum Export zusammenführen.
  • Nach jeder Änderung: schleusen (gate), dann mit look aus angles in Clay-Shading betrachten, um die Form zu beurteilen.

Individual skills in this repo

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

Verwandte Skills