Communitygithub.com

dnlgalleguillos/gauge-modeling

bmesh와 Blender 데이터 API를 사용하여 하드 서피스 및 프로프 메시를 모델링하고, n-gon, 구멍, 뒤집힌 노멀, 중복 및 느슨한 지오메트리, UV 밀도 등 수치로 검증합니다. 베벨 부품 키트, 게이트 및 안전한 수리 스크립트를 제공합니다. 메시를 제작하거나 검토할 때 사용하세요.

gauge-modeling란 무엇인가요?

이 스킬은 Blender에서 bmesh/데이터 API를 활용하여 하드 서피스 및 프로프 메시를 모델링하고, 수치 기반 검증(게이트)을 수행하는 포괄적인 도구 모음입니다. UI 컨텍스트 없이도 작동하며, 모디파이어와 지오메트리 노드가 적용된 평가된 메시를 게이트하여 정확한 검사를 보장합니다. 주요 기능으로는 라운드 박스, 실린더, 볼트 헤드 등을 생성하는 빌더 스크립트(scripts/kit.py), JSON 부품 목록에서 전체 프로프를 빌드하는 스크립트(scripts/build_prop.py), 느슨한 지오메트리, 뒤집힌 노멀, n-gon, 삼각형, UV 밀도 등을 검사하는 메시 게이트(scripts/mesh_gate.py), 그리고 안전하게 문제를 수정하는 fix_mesh.py 등이 있습니다. 이 스킬은 Claude Code, Cursor, Codex 등 Blender Python API를 사용할 수 있는 모든 AI 에이전트 플랫폼에서 사용할 수 있으며, 게임 에셋, 건축 시각화, 제품 디자인 등 엄격한 메시 품질 기준이 필요한 파이프라인에 특히 유용합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/dnlgalleguillos/blender-gauge/tree/HEAD/skills/gauge-modeling

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Gauge 모델링

bmesh/데이터 API로 빌드하고 (UI 컨텍스트 불필요), 평가된 메시를 게이트하여 모디파이어와 지오메트리 노드가 적용된 상태를 검사합니다.

빌드

scripts/kit.py (옆에 있는 스크립트에서 임포트):

함수생성 결과물
rounded_box(name, size, bevel, segments, loc, rot, collection)실제 베벨이 적용된 박스, 각도 기반 스무딩
cylinder(name, radius, depth, segments, bevel, ...)베벨 처리된 캡이 있는 실린더
bolt_head(name, radius, height, sides, bevel, ...)육각 (또는 원형) 볼트 헤드
cut_holes(target, [(u, v, r), ...])가장 얇은 축을 따라 원형 구멍을 뚫음 (불리언 후 베이크)
bake_modifiers(ob)bpy.ops 없이 전체 모디파이어 스택 적용
assign(ob, material)단일 머티리얼 슬롯 할당

빌더는 동일한 이름의 오브젝트를 대체하므로 스크립트를 재실행할 수 있습니다. scripts/build_prop.py는 JSON 부품 목록 (또는 데모 크레이트)에서 전체 프로프를 자체 컬렉션으로 빌드하고 게이트합니다:

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

게이트

scripts/mesh_gate.py -> mesh-health 게이트.

검사 항목실패 조건일반적인 수정 방법
loose_verts, zero_area_faces, `duplicate_verts``하나라도 있으면fix_mesh.py
non_manifold_edges3개 이상의 면이 공유하는 모서리해당 영역 재구성
inverted_volume닫힌 메시에서 음수 부피fix_mesh.py (normals)
ngonsmax_ngons 초과 (옵트인)fix_mesh.py (triangulate_ngons) 또는 재쿼드
trianglesmax_tris 초과 (옵트인)디시메이트, 베벨 세그먼트 줄이기
closed_meshesrequire_closed인데 구멍 존재채우기
has_uv, texel_density_cvrequire_uv / 지정된 제한 위반언랩, 아일랜드 스케일 균일화

fix_mesh.py는 apply=true가 될 때까지 드라이 런(dry run)입니다. 선택 영역 외부에서 공유되는 메시 데이터는 절대 건드리지 않습니다.

규칙

  • 실제 크기(미터) 우선, 그 다음 베벨: 베벨은 가장 작은 치수의 1-4%입니다. 베벨이 없는 하드 엣지는 빛을 받지 못합니다.
  • 베벨 후 스무딩: 면별 플래그 대신 각도(35도) 기반 스무딩.
  • 불리언은 절단면에 n-gon을 남깁니다: 스틸 이미지에는 문제없지만, 엔진으로 내보내기 전에 삼각화하세요.
  • 파트는 끝까지 별도의 명명된 오브젝트로 유지하고, 내보내기 직전에만 결합하세요.
  • 변경 후에는 항상 게이트를 실행하고, 클레이 쉐이딩에서 angles의 look으로 형태를 평가하세요.

Individual skills in this repo

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

관련 스킬