el4cteo/blender-skills

blender-facial-shapekeys

Facial rigs and shape keys in Blender 5.3 - ARKit 52 blendshapes, visemes for lip-sync, sculpting expressions, splitting symmetric shapes into Left/Right, mirroring, corrective and combination shapes, drivers and control rigs, bone+blendshape hybrids, expor…

소스 보기

사용 방법

  1. 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
  2. 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
  3. 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/el4cteo/blender-skills --skill blender-facial-shapekeys

시작 전 확인

  • 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
  • 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 Skill 문서

원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.

Facial Rig & Shape Keys

The execution model is in blender-core. The body rig is in blender-character-rigging.

Choose the approach

ApproachUseNotes
Blendshapes (ARKit 52)games, VTubers, mocap (iPhone/Live Link Face), web/VRMthe industry interchange set; each shape is sculpted
Bones (jaw, eyes, lids, brows, lips)stylized, low memory, mobilejaw + eyes as bones are almost always right
Hybridmost production game headsjaw/eye/tongue bones + blendshapes for everything soft
Rigify face (human metarig)film-style keyframe animation inside Blender100+ face bones, heavy for engines

Procedure (blendshapes)

  1. The head mesh needs clean loops around the eyes and mouth (blender-retopology-uv), with eyes, teeth and tongue as separate objects parented or weighted to bones.
  2. scripts/shapekeys.py -- --mesh Head --create arkit (or --create visemes for the 15 Oculus visemes) creates empty, correctly named keys.
  3. Sculpt each key (live: sculpt mode on the active key, use_shape_key_edit_mode). Symmetric expressions can be sculpted once, then --split eyeBlink gives eyeBlinkLeft/Right with a soft blend across X=0 (--falloff m).
  4. --mirror browDownLeft builds browDownRight (topology-independent mirror).
  5. --report lists unsculpted keys, the max offset per key, and missing ARKit names. A shape is done only when every key moves and nothing is left over.
  6. Optional: --drivers FaceCtrl adds a controller with 0–1 custom properties driving each key, for keyframing in Blender.
  7. Check the extremes and combinations (jawOpen + mouthSmile, eyeBlink + eyeSquint) with look. Fix them with corrective combination keys driven by the product of two keys.

Shape key rules

  • Shapes are deltas from Basis. Never change the Basis topology after creating keys (adding or removing verts destroys every key).
  • One action per key. No head or neck movement inside face keys (bones do that). Keep eyelids sliding over the eye surface, not through it (check with blender-asset-qa zfighting on lid/eye).
  • Range 0–1. slider_max can be raised for exaggeration, but engines clamp to 0–1.
  • Relative keys (use_relative=True, the default) are the only kind that exports.
  • Name exactly per spec (case-sensitive): eyeBlinkLeft, not EyeBlink_L. Engines map by name.
  • Keys on meshes with Subdivision: sculpt at level 0, and keep the subdivision modifier after the shape keys (they're evaluated first anyway).
  • Applying modifiers on a mesh with shape keys fails. Use modifier_apply_as_shapekey for deform modifiers, or apply them before creating keys.

Correctives and combination shapes

  • Corrective for a bone pose: sculpt in the posed state, then drive with a TRANSFORMS variable (ROT_X, LOCAL_SPACE, mapped to 0–1).
  • Combination: key jawOpen_mouthSmile with driver SCRIPTED expression a*b, from the two key values (SINGLE_PROP key_blocks["jawOpen"].value). Simple expressions don't need Python auto-run.

Engine notes

  • Unity: FBX blendshapes. In the Model importer, set Blend Shape Normals = Calculate (or Import if smoothing was exported). ARKit names map to the AR Foundation face-tracking samples.
  • Unreal: morph targets ("Import Morph Targets"). Live Link Face / MetaHuman Animator use ARKit names, and the Pose Asset maps the curves. No leaf bones.
  • Roblox dynamic heads: FACS-based poses with Roblox-specific names, authored as animation frames on a head rig (Creator Hub "Dynamic heads" spec). Build from the official Blender template. ARKit sculpts can be reused by renaming/mapping. Head ≤ 4,000 tris.
  • VRM / web (three-vrm, ReadyPlayerMe-style): ARKit 52 + visemes as glTF morph targets (export_morph=True). Keep the morph-normal export on only if shading needs it (it doubles the size).
  • Drop unused keys before export. Every key costs memory per vertex (glTF sparse accessors help).

Gotchas

  • ob.shape_key_add(from_mix=False) copies the Basis. from_mix=True bakes the current mix (useful for combos, dangerous by accident).
  • shape_key_mirror(use_topology=False) needs a mesh symmetric on X. Run it on the active key (the script handles this).
  • Driver variables on shape keys use the Key ID (ob.data.shape_keys), not the mesh: fc = kb.driver_add("value").
같은 저장소의 Skills

더 많은 Skills

모든 Skills
el4cteo
커뮤니티

blender-environment-kits

Game environments in Blender 5.3 - terrain from noise or heightmaps (erosion, terraces, play areas, slope/height materials, 16-bit heightmaps + splat maps for UE/Unity), biome scatter by slope/height/mask with Poisson spacing, modular kit metrics and validation (grid, pivots, seams, texel density). Use for levels, landscapes, forests, modular buildings, dungeons.

1시간 설치 수
4
GitHub Stars
2.5천
업데이트
11월 17일
el4cteo
커뮤니티

blender-geometry-nodes

Geometry Nodes in Blender 5.3 - fields, domains, attributes, instancing, zones (simulation/repeat/for-each), closures/bundles, lists, SDF grids, node tools, baking, plus a JSON-to-node-tree builder and socket inspector. Use for scattering, procedural assets/environments, parametric tools and modifier inputs.

1시간 설치 수
4
GitHub Stars
2.5천
업데이트
11월 17일
el4cteo
커뮤니티

blender-lighting-lookdev

Lighting, cameras and look-dev in Blender 5.3 - studio 3-point and product lighting, HDRI environments, sun/sky exteriors, interiors, light linking, physically based light units, camera focal lengths/composition/DOF, cyclorama backdrops, looping turntables for asset presentation. Use when presenting assets, setting up scenes for rendering, or judging materials under consistent light.

1시간 설치 수
4
GitHub Stars
2.5천
업데이트
11월 17일
el4cteo
커뮤니티

blender-rendering

Render with Blender 5.3 Cycles/EEVEE/Workbench - quality presets, GPU setup, adaptive sampling, denoising, light paths, color management (AgX, Khronos PBR Neutral, ACES), PNG/EXR/MP4 output, passes, the 5.0 compositor API, CLI and multi-camera batch rendering. Use for any still, animation or turntable render.

1시간 설치 수
4
GitHub Stars
2.5천
업데이트
11월 17일